POST/api/v1/tickets

Product availabilityAlgaPSAAlgaDesk

Create ticket

Creates ticket via ApiTicketController.create().

RBAC · ticket

Query parameters

pagestringOptional

limitstringOptional

sortstringOptional

orderstringOptional

fieldsstringOptional

searchstringOptional

querystringOptional

Request body

Content type: application/json · schema WorkV1CreateTicketBody

titlestring

summarystring

urlstring <uri>

Optional link-out for the ticket; any URL accepted by the ticket create schema. Omit or supply a valid URL; null is rejected.

client_idstring <uuid>

board_idstring <uuid>

priority_idstring <uuid>

status_idstring <uuid>

severity_idstring <uuid>

Optional severity reference (same tenant); stored as a nullable UUID. Distinct from numeric itil_impact/itil_urgency; null is rejected.

urgency_idstring <uuid>

Optional urgency reference (same tenant); stored as a nullable UUID. Distinct from numeric itil_impact/itil_urgency; null is rejected.

impact_idstring <uuid>

Optional impact reference (same tenant); stored as a nullable UUID. Distinct from numeric itil_impact/itil_urgency; null is rejected.

external_linksarray of object

Ticket-level external references written in the same transaction as the ticket. A conflicting link rolls back the create.

itemsobject

systemstringRequired

Built-in system key or custom:<slug>.

min length 1

external_idstringRequired

Identifier of the record in the external system.

min length 1

external_parent_idstringNullable

realmstringNullable

Repo, server, or workspace the record lives in.

urlstring <uri>Nullable

Explicit link-out; must be http(s).

relationshipstring

Enum: originmirrorreference

actorobjectNullable

external_statusstringNullable

Response body

Success response 200 · schema WorkV1ApiSuccess

dataanyOfRequired

anyOf (option 1)object

anyOf (option 2)array of object

itemsobject

metaobject

Response codes

200

Operation succeeded.

201

Create-like operation succeeded.

400

Validation or request parsing failure.

401

API key missing/invalid or associated user missing.

403

RBAC denied for ticket resource action.

500

Unexpected controller/service failure.

POST /api/v1/tickets

cURL

curl -X POST "https://algapsa.com/api/v1/tickets?page=string&limit=string&sort=string&order=asc&fields=string&search=string" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "summary": "string",
  "url": "https://example.com",
  "client_id": "01HN2K7VRB9PQ3Y0000000000",
  "board_id": "01HN2K7VRB9PQ3Y0000000000",
  "priority_id": "01HN2K7VRB9PQ3Y0000000000",
  "status_id": "01HN2K7VRB9PQ3Y0000000000",
  "severity_id": "01HN2K7VRB9PQ3Y0000000000",
  "urgency_id": "01HN2K7VRB9PQ3Y0000000000",
  "impact_id": "01HN2K7VRB9PQ3Y0000000000",
  "external_links": [
    {
      "system": "x",
      "external_id": "x",
      "external_parent_id": "string",
      "realm": "string",
      "url": "https://example.com",
      "relationship": "origin",
      "actor": {},
      "external_status": "string"
    }
  ]
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/tickets?page=string&limit=string&sort=string&order=asc&fields=string&search=string", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "title": "string",
    "summary": "string",
    "url": "https://example.com",
    "client_id": "01HN2K7VRB9PQ3Y0000000000",
    "board_id": "01HN2K7VRB9PQ3Y0000000000",
    "priority_id": "01HN2K7VRB9PQ3Y0000000000",
    "status_id": "01HN2K7VRB9PQ3Y0000000000",
    "severity_id": "01HN2K7VRB9PQ3Y0000000000",
    "urgency_id": "01HN2K7VRB9PQ3Y0000000000",
    "impact_id": "01HN2K7VRB9PQ3Y0000000000",
    "external_links": [
      {
        "system": "x",
        "external_id": "x",
        "external_parent_id": "string",
        "realm": "string",
        "url": "https://example.com",
        "relationship": "origin",
        "actor": {},
        "external_status": "string"
      }
    ]
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/v1/tickets?page=string&limit=string&sort=string&order=asc&fields=string&search=string");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""title"": ""string"",
  ""summary"": ""string"",
  ""url"": ""https://example.com"",
  ""client_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""board_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""priority_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""status_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""severity_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""urgency_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""impact_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""external_links"": [
    {
      ""system"": ""x"",
      ""external_id"": ""x"",
      ""external_parent_id"": ""string"",
      ""realm"": ""string"",
      ""url"": ""https://example.com"",
      ""relationship"": ""origin"",
      ""actor"": {},
      ""external_status"": ""string""
    }
  ]
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "data": {},
  "meta": {}
}