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": "28eb2151-0d24-40ea-b900-063eac5e96c4",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "5c85d871-9640-48e4-9277-d24add6a9268",
"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": "bd0d4f5b-6bf6-4a9b-a91a-460c579dbdb6",
"Name": "sample string 2",
"OrganizationId": "c5bc86a7-f190-4851-bc02-48e9836d187e"
},
{
"Id": "bd0d4f5b-6bf6-4a9b-a91a-460c579dbdb6",
"Name": "sample string 2",
"OrganizationId": "c5bc86a7-f190-4851-bc02-48e9836d187e"
}
]
},
"CurrentState": {
"Id": "222b1165-a40d-42db-81d8-e94c9c130e9e",
"Name": "sample string 2"
},
"Organization": {
"Id": "049cbc26-0b81-4db7-9204-cd4c40465049",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "bd0d4f5b-6bf6-4a9b-a91a-460c579dbdb6",
"Name": "sample string 2",
"OrganizationId": "c5bc86a7-f190-4851-bc02-48e9836d187e"
},
{
"Id": "bd0d4f5b-6bf6-4a9b-a91a-460c579dbdb6",
"Name": "sample string 2",
"OrganizationId": "c5bc86a7-f190-4851-bc02-48e9836d187e"
}
],
"EntryTimestamp": "2026-08-13T00:11:21.2320505+00:00",
"ModifiedTimestamp": "2026-08-13T00:11:21.2320505+00:00",
"EventTimestamp": "2026-08-13T00:11:21.2320505+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "d89a29c5-ef56-4dc8-9c11-297a54af576c",
"AvailableReports": [
{
"Id": "9b5989f8-9cbb-4522-a70c-59f8b5e13eee",
"Name": "sample string 2"
},
{
"Id": "9b5989f8-9cbb-4522-a70c-59f8b5e13eee",
"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>9b5989f8-9cbb-4522-a70c-59f8b5e13eee</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>9b5989f8-9cbb-4522-a70c-59f8b5e13eee</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>222b1165-a40d-42db-81d8-e94c9c130e9e</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-13T00:11:21.2320505Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-13T00:11:21.2320505Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>28eb2151-0d24-40ea-b900-063eac5e96c4</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-13T00:11:21.2320505Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>049cbc26-0b81-4db7-9204-cd4c40465049</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>d89a29c5-ef56-4dc8-9c11-297a54af576c</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>5c85d871-9640-48e4-9277-d24add6a9268</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>bd0d4f5b-6bf6-4a9b-a91a-460c579dbdb6</Id>
<Name>sample string 2</Name>
<OrganizationId>c5bc86a7-f190-4851-bc02-48e9836d187e</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>bd0d4f5b-6bf6-4a9b-a91a-460c579dbdb6</Id>
<Name>sample string 2</Name>
<OrganizationId>c5bc86a7-f190-4851-bc02-48e9836d187e</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>bd0d4f5b-6bf6-4a9b-a91a-460c579dbdb6</Id>
<Name>sample string 2</Name>
<OrganizationId>c5bc86a7-f190-4851-bc02-48e9836d187e</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>bd0d4f5b-6bf6-4a9b-a91a-460c579dbdb6</Id>
<Name>sample string 2</Name>
<OrganizationId>c5bc86a7-f190-4851-bc02-48e9836d187e</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": "00b1fbfd-f049-42b3-a96d-2a85501edcea",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "4a37afa5-d197-4eff-a347-182340713a18",
"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": "db65d18e-ba09-4826-8012-2ca635df95e6",
"Name": "sample string 2",
"OrganizationId": "4c5e8b0a-451c-4716-801c-ed45e58754e5"
},
{
"Id": "db65d18e-ba09-4826-8012-2ca635df95e6",
"Name": "sample string 2",
"OrganizationId": "4c5e8b0a-451c-4716-801c-ed45e58754e5"
}
]
},
"CurrentState": {
"Id": "d794d731-55e9-478a-aca7-7b32af6646a8",
"Name": "sample string 2"
},
"Organization": {
"Id": "b92b6c9b-bb02-4c2f-bb8c-8aedfa04dc88",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "db65d18e-ba09-4826-8012-2ca635df95e6",
"Name": "sample string 2",
"OrganizationId": "4c5e8b0a-451c-4716-801c-ed45e58754e5"
},
{
"Id": "db65d18e-ba09-4826-8012-2ca635df95e6",
"Name": "sample string 2",
"OrganizationId": "4c5e8b0a-451c-4716-801c-ed45e58754e5"
}
],
"EntryTimestamp": "2026-08-13T00:11:21.2320505+00:00",
"ModifiedTimestamp": "2026-08-13T00:11:21.2320505+00:00",
"EventTimestamp": "2026-08-13T00:11:21.2320505+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "2ea5fdbc-50ba-4b9d-b567-77b15b33c3ed",
"AvailableReports": [
{
"Id": "deca8a05-0bf9-4efb-8cd5-d1b2963d641c",
"Name": "sample string 2"
},
{
"Id": "deca8a05-0bf9-4efb-8cd5-d1b2963d641c",
"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>deca8a05-0bf9-4efb-8cd5-d1b2963d641c</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>deca8a05-0bf9-4efb-8cd5-d1b2963d641c</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>d794d731-55e9-478a-aca7-7b32af6646a8</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-13T00:11:21.2320505Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-13T00:11:21.2320505Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>00b1fbfd-f049-42b3-a96d-2a85501edcea</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-13T00:11:21.2320505Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>b92b6c9b-bb02-4c2f-bb8c-8aedfa04dc88</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>2ea5fdbc-50ba-4b9d-b567-77b15b33c3ed</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>4a37afa5-d197-4eff-a347-182340713a18</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>db65d18e-ba09-4826-8012-2ca635df95e6</Id>
<Name>sample string 2</Name>
<OrganizationId>4c5e8b0a-451c-4716-801c-ed45e58754e5</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>db65d18e-ba09-4826-8012-2ca635df95e6</Id>
<Name>sample string 2</Name>
<OrganizationId>4c5e8b0a-451c-4716-801c-ed45e58754e5</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>db65d18e-ba09-4826-8012-2ca635df95e6</Id>
<Name>sample string 2</Name>
<OrganizationId>4c5e8b0a-451c-4716-801c-ed45e58754e5</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>db65d18e-ba09-4826-8012-2ca635df95e6</Id>
<Name>sample string 2</Name>
<OrganizationId>4c5e8b0a-451c-4716-801c-ed45e58754e5</OrganizationId>
</RoleSimple>
</WaitingOnRoles>
</CaseSimple>