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": "aca2fafc-5b3c-4a81-b4f6-a025425991d6",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "9479e560-b41b-4434-8f6a-2b84ab847695",
"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": "af2bf65e-d591-4de4-b83c-905d1a519f68",
"Name": "sample string 2",
"OrganizationId": "128e3390-72f0-42a3-9fa6-51f35fd0dfd0"
},
{
"Id": "af2bf65e-d591-4de4-b83c-905d1a519f68",
"Name": "sample string 2",
"OrganizationId": "128e3390-72f0-42a3-9fa6-51f35fd0dfd0"
}
]
},
"CurrentState": {
"Id": "a3df2a3e-6fa7-4542-965c-c554b7df705a",
"Name": "sample string 2"
},
"Organization": {
"Id": "2c09cd45-9156-4746-b145-6191f4615d8c",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "af2bf65e-d591-4de4-b83c-905d1a519f68",
"Name": "sample string 2",
"OrganizationId": "128e3390-72f0-42a3-9fa6-51f35fd0dfd0"
},
{
"Id": "af2bf65e-d591-4de4-b83c-905d1a519f68",
"Name": "sample string 2",
"OrganizationId": "128e3390-72f0-42a3-9fa6-51f35fd0dfd0"
}
],
"EntryTimestamp": "2025-12-14T19:14:22.1856014+00:00",
"ModifiedTimestamp": "2025-12-14T19:14:22.1856014+00:00",
"EventTimestamp": "2025-12-14T19:14:22.1856014+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "b45252c3-f943-4fb5-9e87-6b67bbde9388",
"AvailableReports": [
{
"Id": "0c67e2f5-fbc1-4e30-a008-79a85cdec7ae",
"Name": "sample string 2"
},
{
"Id": "0c67e2f5-fbc1-4e30-a008-79a85cdec7ae",
"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>0c67e2f5-fbc1-4e30-a008-79a85cdec7ae</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>0c67e2f5-fbc1-4e30-a008-79a85cdec7ae</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>a3df2a3e-6fa7-4542-965c-c554b7df705a</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2025-12-14T19:14:22.1856014Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2025-12-14T19:14:22.1856014Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>aca2fafc-5b3c-4a81-b4f6-a025425991d6</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2025-12-14T19:14:22.1856014Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>2c09cd45-9156-4746-b145-6191f4615d8c</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>b45252c3-f943-4fb5-9e87-6b67bbde9388</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>9479e560-b41b-4434-8f6a-2b84ab847695</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>af2bf65e-d591-4de4-b83c-905d1a519f68</Id>
<Name>sample string 2</Name>
<OrganizationId>128e3390-72f0-42a3-9fa6-51f35fd0dfd0</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>af2bf65e-d591-4de4-b83c-905d1a519f68</Id>
<Name>sample string 2</Name>
<OrganizationId>128e3390-72f0-42a3-9fa6-51f35fd0dfd0</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>af2bf65e-d591-4de4-b83c-905d1a519f68</Id>
<Name>sample string 2</Name>
<OrganizationId>128e3390-72f0-42a3-9fa6-51f35fd0dfd0</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>af2bf65e-d591-4de4-b83c-905d1a519f68</Id>
<Name>sample string 2</Name>
<OrganizationId>128e3390-72f0-42a3-9fa6-51f35fd0dfd0</OrganizationId>
</RoleSimple>
</WaitingOnRoles>
</CaseSimple>
application/x-www-form-urlencoded
Sample:
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": "916b2b27-f942-4987-8d25-8cf22d1bcc09",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "735bd717-6623-45b1-8a18-ce2bdb08b452",
"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": "454f16ca-d2ef-46ae-8cda-6142cd458803",
"Name": "sample string 2",
"OrganizationId": "16f6e337-06f0-45db-b577-03939295fd7e"
},
{
"Id": "454f16ca-d2ef-46ae-8cda-6142cd458803",
"Name": "sample string 2",
"OrganizationId": "16f6e337-06f0-45db-b577-03939295fd7e"
}
]
},
"CurrentState": {
"Id": "664e2698-0de9-41ca-8435-0a0042d5b705",
"Name": "sample string 2"
},
"Organization": {
"Id": "21198c57-478d-424b-a52e-21b1c59fda53",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "454f16ca-d2ef-46ae-8cda-6142cd458803",
"Name": "sample string 2",
"OrganizationId": "16f6e337-06f0-45db-b577-03939295fd7e"
},
{
"Id": "454f16ca-d2ef-46ae-8cda-6142cd458803",
"Name": "sample string 2",
"OrganizationId": "16f6e337-06f0-45db-b577-03939295fd7e"
}
],
"EntryTimestamp": "2025-12-14T19:14:22.1856014+00:00",
"ModifiedTimestamp": "2025-12-14T19:14:22.1856014+00:00",
"EventTimestamp": "2025-12-14T19:14:22.1856014+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "aaaf0923-e55d-41b5-a657-23f5be05b9e6",
"AvailableReports": [
{
"Id": "ca98d98c-8a47-479f-a571-78512fdbe40e",
"Name": "sample string 2"
},
{
"Id": "ca98d98c-8a47-479f-a571-78512fdbe40e",
"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>ca98d98c-8a47-479f-a571-78512fdbe40e</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>ca98d98c-8a47-479f-a571-78512fdbe40e</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>664e2698-0de9-41ca-8435-0a0042d5b705</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2025-12-14T19:14:22.1856014Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2025-12-14T19:14:22.1856014Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>916b2b27-f942-4987-8d25-8cf22d1bcc09</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2025-12-14T19:14:22.1856014Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>21198c57-478d-424b-a52e-21b1c59fda53</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>aaaf0923-e55d-41b5-a657-23f5be05b9e6</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>735bd717-6623-45b1-8a18-ce2bdb08b452</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>454f16ca-d2ef-46ae-8cda-6142cd458803</Id>
<Name>sample string 2</Name>
<OrganizationId>16f6e337-06f0-45db-b577-03939295fd7e</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>454f16ca-d2ef-46ae-8cda-6142cd458803</Id>
<Name>sample string 2</Name>
<OrganizationId>16f6e337-06f0-45db-b577-03939295fd7e</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>454f16ca-d2ef-46ae-8cda-6142cd458803</Id>
<Name>sample string 2</Name>
<OrganizationId>16f6e337-06f0-45db-b577-03939295fd7e</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>454f16ca-d2ef-46ae-8cda-6142cd458803</Id>
<Name>sample string 2</Name>
<OrganizationId>16f6e337-06f0-45db-b577-03939295fd7e</OrganizationId>
</RoleSimple>
</WaitingOnRoles>
</CaseSimple>