RoadOps Developer Docs - Ticket Types

List ticket types

GET/v1/teams/{teamId}/ticket-types

Lists ticket types for a team.

Required scopes: ticket_type:read

`path.teamId`required	`string:uuid` Team identifier.
`query.limit`	`integer` Maximum number of records to return. Defaults to 50 and is capped at 200.
`query.cursor`	`string` Cursor returned by page.nextCursor from the previous list response.

`data`	`object[]`
`data[].name`	`string`
`data[].abbreviation`	`string`
`data[].kind`	`"ticket"` Catalog entry kind.
`data[].isArchived`	`boolean`
`data[].isDefault`	`boolean`
`data[].id`	`string:uuid`
`data[].orgId`	`string:uuid`
`data[].isDeleted`	`boolean`
`data[].version`	`integer` Current ticket type aggregate version.
`data[].createdAt`	`string:date-time` ISO 8601 timestamp when the ticket type was created.
`data[].createdBy`	`string` User identifier that created the ticket type.
`data[].updatedAt`	`string:date-time` ISO 8601 timestamp when the ticket type was last updated.
`data[].updatedBy`	`string` User identifier that last updated the ticket type.
`data[].cursor`	`integer` Latest event-ledger cursor projected into this ticket type record.
`page`	`object`
`page.limit`	`integer` Maximum number of records returned in this page.
`page.nextCursor`	`string \| null` Cursor to pass as the next request's cursor query parameter, or null when there are no more results.
`meta`	`object`
`meta.cursor`	`number \| null` Highest record cursor represented by this response.

POST/v1/teams/{teamId}/ticket-types

Accepts a command to create a ticket type.

Required scopes: ticket_type:write

`path.teamId`required	`string:uuid` Team identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

`name`required	`string`
`abbreviation`required	`string`
`isArchived`	`boolean`
`isDefault`	`boolean`
`id`	`string:uuid` Optional caller-supplied ticket type ID. RoadOps generates one when omitted.

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

GET/v1/teams/{teamId}/ticket-types/{ticketTypeId}

Returns one ticket type by ID.

Required scopes: ticket_type:read

`path.teamId`required	`string:uuid` Team identifier.
`path.ticketTypeId`required	`string:uuid` Ticket type identifier.

`data`	`object`
`data.name`	`string`
`data.abbreviation`	`string`
`data.kind`	`"ticket"` Catalog entry kind.
`data.isArchived`	`boolean`
`data.isDefault`	`boolean`
`data.id`	`string:uuid`
`data.orgId`	`string:uuid`
`data.isDeleted`	`boolean`
`data.version`	`integer` Current ticket type aggregate version.
`data.createdAt`	`string:date-time` ISO 8601 timestamp when the ticket type was created.
`data.createdBy`	`string` User identifier that created the ticket type.
`data.updatedAt`	`string:date-time` ISO 8601 timestamp when the ticket type was last updated.
`data.updatedBy`	`string` User identifier that last updated the ticket type.
`data.cursor`	`integer` Latest event-ledger cursor projected into this ticket type record.
`meta`	`object`
`meta.cursor`	`integer` Highest record cursor represented by this response.

PATCH/v1/teams/{teamId}/ticket-types/{ticketTypeId}

Accepts a command to update ticket type fields.

Required scopes: ticket_type:write

`path.teamId`required	`string:uuid` Team identifier.
`path.ticketTypeId`required	`string:uuid` Ticket type identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

`expectedVersion`	`integer` Optional aggregate version guard.
`name`	`string` Updated ticket type name.
`abbreviation`	`string` Updated ticket type abbreviation.
`isArchived`	`boolean` Whether this ticket type is archived.
`isDefault`	`boolean` Whether this ticket type is the team default.

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

DELETE/v1/teams/{teamId}/ticket-types/{ticketTypeId}

Accepts a command to archive a ticket type.

Required scopes: ticket_type:write

`path.teamId`required	`string:uuid` Team identifier.
`path.ticketTypeId`required	`string:uuid` Ticket type identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

`archivedAt`	`string:date-time` Optional archive timestamp.

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.