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": "16088d4b-1e85-4928-b755-4a1cc27dbfd0",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "86f48f21-a391-4223-b0d3-26bcac68a0ee",
"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": "222f7591-6b21-442f-82e8-77c642990b2c",
"Name": "sample string 2",
"OrganizationId": "3c88ba2d-193d-46a1-8a31-a5eb11752215"
},
{
"Id": "222f7591-6b21-442f-82e8-77c642990b2c",
"Name": "sample string 2",
"OrganizationId": "3c88ba2d-193d-46a1-8a31-a5eb11752215"
}
]
},
"CurrentState": {
"Id": "ec9cf716-1fda-4f62-930c-dce037954e8e",
"Name": "sample string 2"
},
"Organization": {
"Id": "d259e4a6-99eb-480a-a8c2-3386948904aa",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "222f7591-6b21-442f-82e8-77c642990b2c",
"Name": "sample string 2",
"OrganizationId": "3c88ba2d-193d-46a1-8a31-a5eb11752215"
},
{
"Id": "222f7591-6b21-442f-82e8-77c642990b2c",
"Name": "sample string 2",
"OrganizationId": "3c88ba2d-193d-46a1-8a31-a5eb11752215"
}
],
"EntryTimestamp": "2026-03-28T22:22:05.1516409+00:00",
"ModifiedTimestamp": "2026-03-28T22:22:05.1516409+00:00",
"EventTimestamp": "2026-03-28T22:22:05.1516409+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "8366fdbf-cbd3-4336-947f-a2e8e4d50193",
"AvailableReports": [
{
"Id": "1fdf5786-4ad0-4248-ae58-ac381fc2e9e7",
"Name": "sample string 2"
},
{
"Id": "1fdf5786-4ad0-4248-ae58-ac381fc2e9e7",
"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>1fdf5786-4ad0-4248-ae58-ac381fc2e9e7</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>1fdf5786-4ad0-4248-ae58-ac381fc2e9e7</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>ec9cf716-1fda-4f62-930c-dce037954e8e</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-03-28T22:22:05.1516409Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-03-28T22:22:05.1516409Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>16088d4b-1e85-4928-b755-4a1cc27dbfd0</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-03-28T22:22:05.1516409Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>d259e4a6-99eb-480a-a8c2-3386948904aa</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>8366fdbf-cbd3-4336-947f-a2e8e4d50193</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>86f48f21-a391-4223-b0d3-26bcac68a0ee</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>222f7591-6b21-442f-82e8-77c642990b2c</Id>
<Name>sample string 2</Name>
<OrganizationId>3c88ba2d-193d-46a1-8a31-a5eb11752215</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>222f7591-6b21-442f-82e8-77c642990b2c</Id>
<Name>sample string 2</Name>
<OrganizationId>3c88ba2d-193d-46a1-8a31-a5eb11752215</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>222f7591-6b21-442f-82e8-77c642990b2c</Id>
<Name>sample string 2</Name>
<OrganizationId>3c88ba2d-193d-46a1-8a31-a5eb11752215</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>222f7591-6b21-442f-82e8-77c642990b2c</Id>
<Name>sample string 2</Name>
<OrganizationId>3c88ba2d-193d-46a1-8a31-a5eb11752215</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": "14b6e20a-7aaa-47fe-9e9f-4fe2118739a6",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "b5d64ddd-bab7-40e3-82d2-c5cafc24a811",
"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": "df8015c8-1f72-4315-b990-7ce8596dacdc",
"Name": "sample string 2",
"OrganizationId": "91fc0bb3-6435-499b-8935-f5ecd6d13ce5"
},
{
"Id": "df8015c8-1f72-4315-b990-7ce8596dacdc",
"Name": "sample string 2",
"OrganizationId": "91fc0bb3-6435-499b-8935-f5ecd6d13ce5"
}
]
},
"CurrentState": {
"Id": "1f90b1ef-f7a7-4014-ae99-0d3b3579b5cd",
"Name": "sample string 2"
},
"Organization": {
"Id": "ce565579-2b91-4cf9-8e25-ec8c62497a09",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "df8015c8-1f72-4315-b990-7ce8596dacdc",
"Name": "sample string 2",
"OrganizationId": "91fc0bb3-6435-499b-8935-f5ecd6d13ce5"
},
{
"Id": "df8015c8-1f72-4315-b990-7ce8596dacdc",
"Name": "sample string 2",
"OrganizationId": "91fc0bb3-6435-499b-8935-f5ecd6d13ce5"
}
],
"EntryTimestamp": "2026-03-28T22:22:05.7298983+00:00",
"ModifiedTimestamp": "2026-03-28T22:22:05.7298983+00:00",
"EventTimestamp": "2026-03-28T22:22:05.7298983+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "33cd47f2-1dbd-4c1e-950b-21a1f3550e99",
"AvailableReports": [
{
"Id": "5b37b4fd-35c3-462f-92fe-c14a85701bd7",
"Name": "sample string 2"
},
{
"Id": "5b37b4fd-35c3-462f-92fe-c14a85701bd7",
"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>5b37b4fd-35c3-462f-92fe-c14a85701bd7</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>5b37b4fd-35c3-462f-92fe-c14a85701bd7</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>1f90b1ef-f7a7-4014-ae99-0d3b3579b5cd</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-03-28T22:22:05.7298983Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-03-28T22:22:05.7298983Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>14b6e20a-7aaa-47fe-9e9f-4fe2118739a6</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-03-28T22:22:05.7298983Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>ce565579-2b91-4cf9-8e25-ec8c62497a09</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>33cd47f2-1dbd-4c1e-950b-21a1f3550e99</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>b5d64ddd-bab7-40e3-82d2-c5cafc24a811</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>df8015c8-1f72-4315-b990-7ce8596dacdc</Id>
<Name>sample string 2</Name>
<OrganizationId>91fc0bb3-6435-499b-8935-f5ecd6d13ce5</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>df8015c8-1f72-4315-b990-7ce8596dacdc</Id>
<Name>sample string 2</Name>
<OrganizationId>91fc0bb3-6435-499b-8935-f5ecd6d13ce5</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>df8015c8-1f72-4315-b990-7ce8596dacdc</Id>
<Name>sample string 2</Name>
<OrganizationId>91fc0bb3-6435-499b-8935-f5ecd6d13ce5</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>df8015c8-1f72-4315-b990-7ce8596dacdc</Id>
<Name>sample string 2</Name>
<OrganizationId>91fc0bb3-6435-499b-8935-f5ecd6d13ce5</OrganizationId>
</RoleSimple>
</WaitingOnRoles>
</CaseSimple>