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": "643ab3f3-313d-4933-bd58-b8c3ec19328f",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "9c0564b4-7b76-473d-be13-bb3790bdc8db",
"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": "1ec243a3-9d1a-40f0-a783-fa134432080e",
"Name": "sample string 2",
"OrganizationId": "97eef8df-00a0-461c-83ac-59119681cb6d"
},
{
"Id": "1ec243a3-9d1a-40f0-a783-fa134432080e",
"Name": "sample string 2",
"OrganizationId": "97eef8df-00a0-461c-83ac-59119681cb6d"
}
]
},
"CurrentState": {
"Id": "1d7bf356-afeb-4605-8fec-1fc9e9eadd07",
"Name": "sample string 2"
},
"Organization": {
"Id": "8a5dc90a-5652-4238-84de-b95c9af6c4fb",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "1ec243a3-9d1a-40f0-a783-fa134432080e",
"Name": "sample string 2",
"OrganizationId": "97eef8df-00a0-461c-83ac-59119681cb6d"
},
{
"Id": "1ec243a3-9d1a-40f0-a783-fa134432080e",
"Name": "sample string 2",
"OrganizationId": "97eef8df-00a0-461c-83ac-59119681cb6d"
}
],
"EntryTimestamp": "2026-08-01T03:18:19.2746903+00:00",
"ModifiedTimestamp": "2026-08-01T03:18:19.2746903+00:00",
"EventTimestamp": "2026-08-01T03:18:19.2746903+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "10e6ff32-8e79-4587-9f3f-8b3940d51e16",
"AvailableReports": [
{
"Id": "8852cd72-8164-44b0-98f8-00cb590da325",
"Name": "sample string 2"
},
{
"Id": "8852cd72-8164-44b0-98f8-00cb590da325",
"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>8852cd72-8164-44b0-98f8-00cb590da325</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>8852cd72-8164-44b0-98f8-00cb590da325</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>1d7bf356-afeb-4605-8fec-1fc9e9eadd07</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-01T03:18:19.2746903Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-01T03:18:19.2746903Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>643ab3f3-313d-4933-bd58-b8c3ec19328f</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-01T03:18:19.2746903Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>8a5dc90a-5652-4238-84de-b95c9af6c4fb</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>10e6ff32-8e79-4587-9f3f-8b3940d51e16</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>9c0564b4-7b76-473d-be13-bb3790bdc8db</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>1ec243a3-9d1a-40f0-a783-fa134432080e</Id>
<Name>sample string 2</Name>
<OrganizationId>97eef8df-00a0-461c-83ac-59119681cb6d</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>1ec243a3-9d1a-40f0-a783-fa134432080e</Id>
<Name>sample string 2</Name>
<OrganizationId>97eef8df-00a0-461c-83ac-59119681cb6d</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>1ec243a3-9d1a-40f0-a783-fa134432080e</Id>
<Name>sample string 2</Name>
<OrganizationId>97eef8df-00a0-461c-83ac-59119681cb6d</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>1ec243a3-9d1a-40f0-a783-fa134432080e</Id>
<Name>sample string 2</Name>
<OrganizationId>97eef8df-00a0-461c-83ac-59119681cb6d</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": "1c8e0d07-1a57-4fe9-ae15-93a9feda26d9",
"FriendlyId": "sample string 1",
"Owner": {
"Id": "897836d7-70cb-4f50-ba12-453578e5bb19",
"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": "20b2bb29-83d9-4f2a-813b-366cf9143ac3",
"Name": "sample string 2",
"OrganizationId": "a00748d2-1120-465f-b750-d968405b47c2"
},
{
"Id": "20b2bb29-83d9-4f2a-813b-366cf9143ac3",
"Name": "sample string 2",
"OrganizationId": "a00748d2-1120-465f-b750-d968405b47c2"
}
]
},
"CurrentState": {
"Id": "e7952e38-8e8f-43f3-89b4-b6bfcfa37071",
"Name": "sample string 2"
},
"Organization": {
"Id": "16940d8f-8105-47a7-b79e-ec67e62714f5",
"Name": "sample string 2",
"IconUrl": "sample string 3"
},
"WaitingOnRoles": [
{
"Id": "20b2bb29-83d9-4f2a-813b-366cf9143ac3",
"Name": "sample string 2",
"OrganizationId": "a00748d2-1120-465f-b750-d968405b47c2"
},
{
"Id": "20b2bb29-83d9-4f2a-813b-366cf9143ac3",
"Name": "sample string 2",
"OrganizationId": "a00748d2-1120-465f-b750-d968405b47c2"
}
],
"EntryTimestamp": "2026-08-01T03:18:19.2746903+00:00",
"ModifiedTimestamp": "2026-08-01T03:18:19.2746903+00:00",
"EventTimestamp": "2026-08-01T03:18:19.2746903+00:00",
"CompletedTransitions": 5,
"TotalTransitions": 6,
"Name": "sample string 7",
"OrganizationId": "086bcd4e-5f46-4540-b4a5-766042ae018b",
"AvailableReports": [
{
"Id": "3a391333-5703-49a0-9e66-d51500ce8e02",
"Name": "sample string 2"
},
{
"Id": "3a391333-5703-49a0-9e66-d51500ce8e02",
"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>3a391333-5703-49a0-9e66-d51500ce8e02</Id>
<Name>sample string 2</Name>
</ReportSimple>
<ReportSimple>
<Id>3a391333-5703-49a0-9e66-d51500ce8e02</Id>
<Name>sample string 2</Name>
</ReportSimple>
</AvailableReports>
<CompletedTransitions>5</CompletedTransitions>
<CurrentState>
<Id>e7952e38-8e8f-43f3-89b4-b6bfcfa37071</Id>
<Name>sample string 2</Name>
</CurrentState>
<EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-01T03:18:19.2746903Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EntryTimestamp>
<EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-01T03:18:19.2746903Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</EventTimestamp>
<FriendlyId>sample string 1</FriendlyId>
<Id>1c8e0d07-1a57-4fe9-ae15-93a9feda26d9</Id>
<ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2026-08-01T03:18:19.2746903Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</ModifiedTimestamp>
<Name>sample string 7</Name>
<Organization>
<IconUrl>sample string 3</IconUrl>
<Id>16940d8f-8105-47a7-b79e-ec67e62714f5</Id>
<Name>sample string 2</Name>
</Organization>
<OrganizationId>086bcd4e-5f46-4540-b4a5-766042ae018b</OrganizationId>
<Owner>
<Email>sample string 6</Email>
<ExternalId>sample string 8</ExternalId>
<FirstName>sample string 3</FirstName>
<Id>897836d7-70cb-4f50-ba12-453578e5bb19</Id>
<LastName>sample string 4</LastName>
<Phone>sample string 7</Phone>
<Roles>
<RoleSimple>
<Id>20b2bb29-83d9-4f2a-813b-366cf9143ac3</Id>
<Name>sample string 2</Name>
<OrganizationId>a00748d2-1120-465f-b750-d968405b47c2</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>20b2bb29-83d9-4f2a-813b-366cf9143ac3</Id>
<Name>sample string 2</Name>
<OrganizationId>a00748d2-1120-465f-b750-d968405b47c2</OrganizationId>
</RoleSimple>
</Roles>
<Title>sample string 5</Title>
<Username>sample string 2</Username>
</Owner>
<TotalTransitions>6</TotalTransitions>
<WaitingOnRoles>
<RoleSimple>
<Id>20b2bb29-83d9-4f2a-813b-366cf9143ac3</Id>
<Name>sample string 2</Name>
<OrganizationId>a00748d2-1120-465f-b750-d968405b47c2</OrganizationId>
</RoleSimple>
<RoleSimple>
<Id>20b2bb29-83d9-4f2a-813b-366cf9143ac3</Id>
<Name>sample string 2</Name>
<OrganizationId>a00748d2-1120-465f-b750-d968405b47c2</OrganizationId>
</RoleSimple>
</WaitingOnRoles>
</CaseSimple>