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	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": "90a34220-9bbb-4bfe-8325-34ddf90d5446",
  "FriendlyId": "sample string 1",
  "Owner": {
    "Id": "f1dc4ea4-e1e1-4fdb-8c8e-64bc5b01769f",
    "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": "4a829de2-3519-4248-be85-0815a650b3a8",
        "Name": "sample string 2",
        "OrganizationId": "8ece23e3-f4ea-4988-8e68-3be51d3a4121"
      },
      {
        "Id": "4a829de2-3519-4248-be85-0815a650b3a8",
        "Name": "sample string 2",
        "OrganizationId": "8ece23e3-f4ea-4988-8e68-3be51d3a4121"
      }
    ]
  },
  "CurrentState": {
    "Id": "bcc798db-7ce9-4bdc-a0d0-0a5fec150c9e",
    "Name": "sample string 2"
  },
  "Organization": {
    "Id": "cc1346f5-0447-4a1e-ba2a-4d9fb0ff5931",
    "Name": "sample string 2",
    "IconUrl": "sample string 3"
  },
  "WaitingOnRoles": [
    {
      "Id": "4a829de2-3519-4248-be85-0815a650b3a8",
      "Name": "sample string 2",
      "OrganizationId": "8ece23e3-f4ea-4988-8e68-3be51d3a4121"
    },
    {
      "Id": "4a829de2-3519-4248-be85-0815a650b3a8",
      "Name": "sample string 2",
      "OrganizationId": "8ece23e3-f4ea-4988-8e68-3be51d3a4121"
    }
  ],
  "EntryTimestamp": "2026-02-04T21:24:38.2114768+00:00",
  "ModifiedTimestamp": "2026-02-04T21:24:38.2114768+00:00",
  "EventTimestamp": "2026-02-04T21:24:38.2114768+00:00",
  "CompletedTransitions": 5,
  "TotalTransitions": 6,
  "Name": "sample string 7",
  "OrganizationId": "b9fedae6-e1ad-4467-8e39-82eb6f2fe2be",
  "AvailableReports": [
    {
      "Id": "20c1456b-2ef0-4f78-b965-06b9eeb7c717",
      "Name": "sample string 2"
    },
    {
      "Id": "20c1456b-2ef0-4f78-b965-06b9eeb7c717",
      "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>20c1456b-2ef0-4f78-b965-06b9eeb7c717</Id>
      <Name>sample string 2</Name>
    </ReportSimple>
    <ReportSimple>
      <Id>20c1456b-2ef0-4f78-b965-06b9eeb7c717</Id>
      <Name>sample string 2</Name>
    </ReportSimple>
  </AvailableReports>
  <CompletedTransitions>5</CompletedTransitions>
  <CurrentState>
    <Id>bcc798db-7ce9-4bdc-a0d0-0a5fec150c9e</Id>
    <Name>sample string 2</Name>
  </CurrentState>
  <EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2026-02-04T21:24:38.2114768Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </EntryTimestamp>
  <EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2026-02-04T21:24:38.2114768Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </EventTimestamp>
  <FriendlyId>sample string 1</FriendlyId>
  <Id>90a34220-9bbb-4bfe-8325-34ddf90d5446</Id>
  <ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2026-02-04T21:24:38.2114768Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ModifiedTimestamp>
  <Name>sample string 7</Name>
  <Organization>
    <IconUrl>sample string 3</IconUrl>
    <Id>cc1346f5-0447-4a1e-ba2a-4d9fb0ff5931</Id>
    <Name>sample string 2</Name>
  </Organization>
  <OrganizationId>b9fedae6-e1ad-4467-8e39-82eb6f2fe2be</OrganizationId>
  <Owner>
    <Email>sample string 6</Email>
    <ExternalId>sample string 8</ExternalId>
    <FirstName>sample string 3</FirstName>
    <Id>f1dc4ea4-e1e1-4fdb-8c8e-64bc5b01769f</Id>
    <LastName>sample string 4</LastName>
    <Phone>sample string 7</Phone>
    <Roles>
      <RoleSimple>
        <Id>4a829de2-3519-4248-be85-0815a650b3a8</Id>
        <Name>sample string 2</Name>
        <OrganizationId>8ece23e3-f4ea-4988-8e68-3be51d3a4121</OrganizationId>
      </RoleSimple>
      <RoleSimple>
        <Id>4a829de2-3519-4248-be85-0815a650b3a8</Id>
        <Name>sample string 2</Name>
        <OrganizationId>8ece23e3-f4ea-4988-8e68-3be51d3a4121</OrganizationId>
      </RoleSimple>
    </Roles>
    <Title>sample string 5</Title>
    <Username>sample string 2</Username>
  </Owner>
  <TotalTransitions>6</TotalTransitions>
  <WaitingOnRoles>
    <RoleSimple>
      <Id>4a829de2-3519-4248-be85-0815a650b3a8</Id>
      <Name>sample string 2</Name>
      <OrganizationId>8ece23e3-f4ea-4988-8e68-3be51d3a4121</OrganizationId>
    </RoleSimple>
    <RoleSimple>
      <Id>4a829de2-3519-4248-be85-0815a650b3a8</Id>
      <Name>sample string 2</Name>
      <OrganizationId>8ece23e3-f4ea-4988-8e68-3be51d3a4121</OrganizationId>
    </RoleSimple>
  </WaitingOnRoles>
</CaseSimple>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'CaseSimple'.

Response Information

Resource Description

CaseSimple

Name	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": "a2c9eaca-9823-4123-aa2c-02bb16005161",
  "FriendlyId": "sample string 1",
  "Owner": {
    "Id": "394d9507-d428-4ebb-8b52-56c594ee15fb",
    "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": "ce4c7fc8-c8c0-41a4-a1c7-6e7e2da649ba",
        "Name": "sample string 2",
        "OrganizationId": "6bd0ec4d-d68f-4f15-9518-e223bfa31b99"
      },
      {
        "Id": "ce4c7fc8-c8c0-41a4-a1c7-6e7e2da649ba",
        "Name": "sample string 2",
        "OrganizationId": "6bd0ec4d-d68f-4f15-9518-e223bfa31b99"
      }
    ]
  },
  "CurrentState": {
    "Id": "9fd507cc-e492-4015-873f-4758c3f5bcd4",
    "Name": "sample string 2"
  },
  "Organization": {
    "Id": "c6e4f7d6-f13d-4e65-b32f-9b9852989f9a",
    "Name": "sample string 2",
    "IconUrl": "sample string 3"
  },
  "WaitingOnRoles": [
    {
      "Id": "ce4c7fc8-c8c0-41a4-a1c7-6e7e2da649ba",
      "Name": "sample string 2",
      "OrganizationId": "6bd0ec4d-d68f-4f15-9518-e223bfa31b99"
    },
    {
      "Id": "ce4c7fc8-c8c0-41a4-a1c7-6e7e2da649ba",
      "Name": "sample string 2",
      "OrganizationId": "6bd0ec4d-d68f-4f15-9518-e223bfa31b99"
    }
  ],
  "EntryTimestamp": "2026-02-04T21:24:38.2114768+00:00",
  "ModifiedTimestamp": "2026-02-04T21:24:38.2114768+00:00",
  "EventTimestamp": "2026-02-04T21:24:38.2114768+00:00",
  "CompletedTransitions": 5,
  "TotalTransitions": 6,
  "Name": "sample string 7",
  "OrganizationId": "3c514f44-cf14-4893-8ee0-240120200bae",
  "AvailableReports": [
    {
      "Id": "8263238e-53df-4c15-996a-d6e2efbf271d",
      "Name": "sample string 2"
    },
    {
      "Id": "8263238e-53df-4c15-996a-d6e2efbf271d",
      "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>8263238e-53df-4c15-996a-d6e2efbf271d</Id>
      <Name>sample string 2</Name>
    </ReportSimple>
    <ReportSimple>
      <Id>8263238e-53df-4c15-996a-d6e2efbf271d</Id>
      <Name>sample string 2</Name>
    </ReportSimple>
  </AvailableReports>
  <CompletedTransitions>5</CompletedTransitions>
  <CurrentState>
    <Id>9fd507cc-e492-4015-873f-4758c3f5bcd4</Id>
    <Name>sample string 2</Name>
  </CurrentState>
  <EntryTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2026-02-04T21:24:38.2114768Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </EntryTimestamp>
  <EventTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2026-02-04T21:24:38.2114768Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </EventTimestamp>
  <FriendlyId>sample string 1</FriendlyId>
  <Id>a2c9eaca-9823-4123-aa2c-02bb16005161</Id>
  <ModifiedTimestamp xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2026-02-04T21:24:38.2114768Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ModifiedTimestamp>
  <Name>sample string 7</Name>
  <Organization>
    <IconUrl>sample string 3</IconUrl>
    <Id>c6e4f7d6-f13d-4e65-b32f-9b9852989f9a</Id>
    <Name>sample string 2</Name>
  </Organization>
  <OrganizationId>3c514f44-cf14-4893-8ee0-240120200bae</OrganizationId>
  <Owner>
    <Email>sample string 6</Email>
    <ExternalId>sample string 8</ExternalId>
    <FirstName>sample string 3</FirstName>
    <Id>394d9507-d428-4ebb-8b52-56c594ee15fb</Id>
    <LastName>sample string 4</LastName>
    <Phone>sample string 7</Phone>
    <Roles>
      <RoleSimple>
        <Id>ce4c7fc8-c8c0-41a4-a1c7-6e7e2da649ba</Id>
        <Name>sample string 2</Name>
        <OrganizationId>6bd0ec4d-d68f-4f15-9518-e223bfa31b99</OrganizationId>
      </RoleSimple>
      <RoleSimple>
        <Id>ce4c7fc8-c8c0-41a4-a1c7-6e7e2da649ba</Id>
        <Name>sample string 2</Name>
        <OrganizationId>6bd0ec4d-d68f-4f15-9518-e223bfa31b99</OrganizationId>
      </RoleSimple>
    </Roles>
    <Title>sample string 5</Title>
    <Username>sample string 2</Username>
  </Owner>
  <TotalTransitions>6</TotalTransitions>
  <WaitingOnRoles>
    <RoleSimple>
      <Id>ce4c7fc8-c8c0-41a4-a1c7-6e7e2da649ba</Id>
      <Name>sample string 2</Name>
      <OrganizationId>6bd0ec4d-d68f-4f15-9518-e223bfa31b99</OrganizationId>
    </RoleSimple>
    <RoleSimple>
      <Id>ce4c7fc8-c8c0-41a4-a1c7-6e7e2da649ba</Id>
      <Name>sample string 2</Name>
      <OrganizationId>6bd0ec4d-d68f-4f15-9518-e223bfa31b99</OrganizationId>
    </RoleSimple>
  </WaitingOnRoles>
</CaseSimple>