POST api/Cases?transitionId={transitionId}
Create a case from the data in CaseSimple If no transitionId is supplied, use the first "Create" transition If a transitionId is supplied, use that if it is a "Create" transition
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| transitionId |
Optional, the particular transition to use to create the case |
globally unique identifier |
None. |
Body Parameters
The Name and OrganizationId to create a new case for
CaseSimple| Name | Description | Type | Additional information |
|---|---|---|---|
| Id | globally unique identifier |
None. |
|
| FriendlyId | string |
None. |
|
| Owner | UserSimple |
None. |
|
| CurrentState | StateSimple |
None. |
|
| Organization | OrganizationSimple |
None. |
|
| WaitingOnRoles | Collection of RoleSimple |
None. |
|
| EntryTimestamp | date |
None. |
|
| ModifiedTimestamp | date |
None. |
|
| EventTimestamp | date |
None. |
|
| CompletedTransitions | integer |
None. |
|
| TotalTransitions | integer |
None. |
|
| Name | string |
Required |
|
| OrganizationId | globally unique identifier |
Required |
|
| AvailableReports | Collection of ReportSimple |
None. |
|
| Links | Collection of Link |
None. |
Request Formats
application/json, text/json
Sample:
{
"Id": "6ac56b2f-0d2e-4a52-b6bb-25d98d33be58",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "66bb803d-7126-44a5-912c-6f00895d6096",
"Username": "sample string 2",
"FirstName": "sample string 3",
"LastName": "sample string 4",
"Title": "sample string 5",
"Email": "sample string 6",
"Phone": "sample string 7",
"ExternalId": "sample string 8",
"Roles": [
{
"Id": "840f3e4b-62f8-4f1b-9d27-8bcdd6572b80",
"Name": "sample string 2",
"OrganizationId": "9caa76ad-dab2-4c19-9072-404fe2bb13f2"
},
{
"Id": "840f3e4b-62f8-4f1b-9d27-8bcdd6572b80",
"Name": "sample string 2",
"OrganizationId": "9caa76ad-dab2-4c19-9072-404fe2bb13f2"
}
]
},
"CurrentState": {
"Id": "793f3fa7-2ecf-4fc0-b6e5-3392724c5691",
"Name": "sample string 2"
},
"Organization": {
"Id": "e73dd9ff-acbf-4106-9aa2-db539e76e9ee",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "840f3e4b-62f8-4f1b-9d27-8bcdd6572b80",
"Name": "sample string 2",
"OrganizationId": "9caa76ad-dab2-4c19-9072-404fe2bb13f2"
},
{
"Id": "840f3e4b-62f8-4f1b-9d27-8bcdd6572b80",
"Name": "sample string 2",
"OrganizationId": "9caa76ad-dab2-4c19-9072-404fe2bb13f2"
}
],
"EntryTimestamp": "2026-05-30T06:15:51.6178575+00:00",
"ModifiedTimestamp": "2026-05-30T06:15:51.6178575+00:00",
"EventTimestamp": "2026-05-30T06:15:51.6178575+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "847f23af-5b92-4f61-bea3-fb25ffe8b1cf",
"AvailableReports": [
{
"Id": "11da8fb9-4de6-4101-9e86-ca89899d887f",
"Name": "sample string 2"
},
{
"Id": "11da8fb9-4de6-4101-9e86-ca89899d887f",
"Name": "sample string 2"
}
],
"Links": []
}
application/xml, text/xml
Sample:
<CaseSimple xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/XCapture.DTO">
<Links />
<AvailableReports>
<ReportSimple>
<Id>11da8fb9-4de6-4101-9e86-ca89899d887f</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>11da8fb9-4de6-4101-9e86-ca89899d887f</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>793f3fa7-2ecf-4fc0-b6e5-3392724c5691</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-05-30T06:15:51.6178575Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-05-30T06:15:51.6178575Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>6ac56b2f-0d2e-4a52-b6bb-25d98d33be58</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-05-30T06:15:51.6178575Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>e73dd9ff-acbf-4106-9aa2-db539e76e9ee</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>847f23af-5b92-4f61-bea3-fb25ffe8b1cf</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>66bb803d-7126-44a5-912c-6f00895d6096</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>840f3e4b-62f8-4f1b-9d27-8bcdd6572b80</Id>
<Name>sample string 2</Name>
<OrganizationId>9caa76ad-dab2-4c19-9072-404fe2bb13f2</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>840f3e4b-62f8-4f1b-9d27-8bcdd6572b80</Id>
<Name>sample string 2</Name>
<OrganizationId>9caa76ad-dab2-4c19-9072-404fe2bb13f2</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>840f3e4b-62f8-4f1b-9d27-8bcdd6572b80</Id>
<Name>sample string 2</Name>
<OrganizationId>9caa76ad-dab2-4c19-9072-404fe2bb13f2</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>840f3e4b-62f8-4f1b-9d27-8bcdd6572b80</Id>
<Name>sample string 2</Name>
<OrganizationId>9caa76ad-dab2-4c19-9072-404fe2bb13f2</OrganizationId>
</RoleSimple>
</WaitingOnRoles>
</CaseSimple>
application/x-www-form-urlencoded
Sample:
Sample not available.
Response Information
Resource Description
CaseSimple| Name | Description | Type | Additional information |
|---|---|---|---|
| Id | globally unique identifier |
None. |
|
| FriendlyId | string |
None. |
|
| Owner | UserSimple |
None. |
|
| CurrentState | StateSimple |
None. |
|
| Organization | OrganizationSimple |
None. |
|
| WaitingOnRoles | Collection of RoleSimple |
None. |
|
| EntryTimestamp | date |
None. |
|
| ModifiedTimestamp | date |
None. |
|
| EventTimestamp | date |
None. |
|
| CompletedTransitions | integer |
None. |
|
| TotalTransitions | integer |
None. |
|
| Name | string |
Required |
|
| OrganizationId | globally unique identifier |
Required |
|
| AvailableReports | Collection of ReportSimple |
None. |
|
| Links | Collection of Link |
None. |
Response Formats
application/json, text/json
Sample:
{
"Id": "d7df2dea-a96f-4516-89f7-a0a2a71fb545",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "e9934e67-6a2f-49b8-9c6d-4544ae67b889",
"Username": "sample string 2",
"FirstName": "sample string 3",
"LastName": "sample string 4",
"Title": "sample string 5",
"Email": "sample string 6",
"Phone": "sample string 7",
"ExternalId": "sample string 8",
"Roles": [
{
"Id": "cbf2ce08-8dc9-449f-a017-d94bbc536a7f",
"Name": "sample string 2",
"OrganizationId": "1ad9d337-6f29-41fd-92e2-a2d4f640f083"
},
{
"Id": "cbf2ce08-8dc9-449f-a017-d94bbc536a7f",
"Name": "sample string 2",
"OrganizationId": "1ad9d337-6f29-41fd-92e2-a2d4f640f083"
}
]
},
"CurrentState": {
"Id": "07eaf941-d011-439e-968b-50250d6389a1",
"Name": "sample string 2"
},
"Organization": {
"Id": "d6f079d2-6566-4923-b2b8-f9ea309b42fa",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "cbf2ce08-8dc9-449f-a017-d94bbc536a7f",
"Name": "sample string 2",
"OrganizationId": "1ad9d337-6f29-41fd-92e2-a2d4f640f083"
},
{
"Id": "cbf2ce08-8dc9-449f-a017-d94bbc536a7f",
"Name": "sample string 2",
"OrganizationId": "1ad9d337-6f29-41fd-92e2-a2d4f640f083"
}
],
"EntryTimestamp": "2026-05-30T06:15:51.6361732+00:00",
"ModifiedTimestamp": "2026-05-30T06:15:51.6361732+00:00",
"EventTimestamp": "2026-05-30T06:15:51.6361732+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "e1fcb55f-636c-4090-8c27-78a95ae28598",
"AvailableReports": [
{
"Id": "0a00ff81-2fd6-46e4-83c2-cd8874fec709",
"Name": "sample string 2"
},
{
"Id": "0a00ff81-2fd6-46e4-83c2-cd8874fec709",
"Name": "sample string 2"
}
],
"Links": []
}
application/xml, text/xml
Sample:
<CaseSimple xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/XCapture.DTO">
<Links />
<AvailableReports>
<ReportSimple>
<Id>0a00ff81-2fd6-46e4-83c2-cd8874fec709</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>0a00ff81-2fd6-46e4-83c2-cd8874fec709</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>07eaf941-d011-439e-968b-50250d6389a1</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-05-30T06:15:51.6361732Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-05-30T06:15:51.6361732Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>d7df2dea-a96f-4516-89f7-a0a2a71fb545</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-05-30T06:15:51.6361732Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>d6f079d2-6566-4923-b2b8-f9ea309b42fa</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>e1fcb55f-636c-4090-8c27-78a95ae28598</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>e9934e67-6a2f-49b8-9c6d-4544ae67b889</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>cbf2ce08-8dc9-449f-a017-d94bbc536a7f</Id>
<Name>sample string 2</Name>
<OrganizationId>1ad9d337-6f29-41fd-92e2-a2d4f640f083</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>cbf2ce08-8dc9-449f-a017-d94bbc536a7f</Id>
<Name>sample string 2</Name>
<OrganizationId>1ad9d337-6f29-41fd-92e2-a2d4f640f083</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>cbf2ce08-8dc9-449f-a017-d94bbc536a7f</Id>
<Name>sample string 2</Name>
<OrganizationId>1ad9d337-6f29-41fd-92e2-a2d4f640f083</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>cbf2ce08-8dc9-449f-a017-d94bbc536a7f</Id>
<Name>sample string 2</Name>
<OrganizationId>1ad9d337-6f29-41fd-92e2-a2d4f640f083</OrganizationId>
</RoleSimple>
</WaitingOnRoles>
</CaseSimple>