Repair tickets

Update a repair ticket

Changes the header of the repair ticket and, if you send lines, REPLACES the whole set of lines: send all of them or none.

PATCH

/api/v1/repair-tickets/{ticketId}

curl https://app.filmo.io/api/v1/repair-tickets/tick_8f2a1c \
  --request PATCH \
  --header "Authorization: Bearer $FILMO_API_KEY" \
  --header "Idempotency-Key: $(uuidgen 2>/dev/null || cat /proc/sys/kernel/random/uuid)" \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "closed",
  "notes": "Reparado en taller propio y devuelto al pool"
}'

Node.jsfetch('https://app.filmo.io/api/v1/repair-tickets/tick_8f2a1c', { method: 'PATCH', headers: { Authorization: 'Bearer YOUR_FILMO_API_KEY', 'Idempotency-Key': crypto.randomUUID(), 'Content-Type': 'application/json' }, body: JSON.stringify({ status: 'closed', notes: 'Reparado en taller propio y devuelto al pool' }) })Pythonimport uuid import requests requests.patch( "https://app.filmo.io/api/v1/repair-tickets/tick_8f2a1c", headers={ "Authorization": "Bearer YOUR_FILMO_API_KEY", "Idempotency-Key": str(uuid.uuid4()), "Content-Type": "application/json" }, json={ "status": "closed", "notes": "Reparado en taller propio y devuelto al pool" } )

{
  "data": {
    "id": "repair_ticket_9f3a2b",
    "number": "2026-0001",
    "date": "2026-09-01T08:00:00.000Z",
    "status": "draft",
    "orderId": "order_9f3a2b",
    "orderNumber": "2026-0001",
    "contactId": "contact_9f3a2b",
    "contactName": "Example contact name",
    "subTotal": "120.00",
    "taxTotal": "120.00",
    "total": "120.00",
    "totalLines": 1,
    "notes": "Example text.",
    "createdAt": "2026-09-01T08:00:00.000Z",
    "updatedAt": "2026-09-01T08:00:00.000Z",
    "projectId": "project_9f3a2b",
    "lines": [
      {
        "id": "line_9f3a2b",
        "entityType": "item",
        "entityId": "entity_9f3a2b",
        "entityName": "Example entity name",
        "description": "Example text.",
        "diagnosis": "Example diagnosis",
        "quantity": 1,
        "unitPrice": "120.00",
        "incidentId": "incident_9f3a2b",
        "notes": "Example text."
      }
    ],
    "sourceIncidentIds": [
      "source_incident_9f3a2b"
    ],
    "customFields": {
      "example": "example"
    }
  }
}

{
  "type": "https://docs.filmo.io/errors/validation_error",
  "title": "Validation error",
  "status": 400,
  "code": "validation_error",
  "detail": "2 validation errors",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "errors": [
    {
      "path": "name",
      "code": "too_small",
      "message": "Must be at least 1 characters long"
    },
    {
      "path": "contactType",
      "code": "invalid_value",
      "message": "Value not allowed; expected company, person"
    }
  ]
}

{
  "type": "https://docs.filmo.io/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "Missing Authorization header: Bearer <api key>",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}

{
  "type": "https://docs.filmo.io/errors/addon_required",
  "title": "Add-on required",
  "status": 402,
  "code": "addon_required",
  "detail": "Your plan does not include the add-on this operation requires",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "requiredAddon": "incidence"
}

{
  "type": "https://docs.filmo.io/errors/insufficient_scope",
  "title": "Insufficient scope",
  "status": 403,
  "code": "insufficient_scope",
  "detail": "The API key does not have the required scope (orders:write)",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "requiredScope": "repair-tickets:write"
}

{
  "type": "https://docs.filmo.io/errors/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "Resource not found",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}

{
  "type": "https://docs.filmo.io/errors/conflict",
  "title": "Conflict",
  "status": 409,
  "code": "conflict",
  "detail": "The current state of the resource does not allow the operation",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "errors": [
    {
      "path": "",
      "code": "invalid_state",
      "message": "The current state of the resource does not allow the operation"
    }
  ]
}

{
  "type": "https://docs.filmo.io/errors/precondition_failed",
  "title": "Precondition failed",
  "status": 412,
  "code": "precondition_failed",
  "detail": "The resource changed since you read it: read it again and retry",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}

{
  "type": "https://docs.filmo.io/errors/idempotency_key_reused",
  "title": "Idempotency-Key reused",
  "status": 422,
  "code": "idempotency_key_reused",
  "detail": "The Idempotency-Key header was already used with a different body",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}

{
  "type": "https://docs.filmo.io/errors/rate_limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limited",
  "detail": "Rate limit exceeded: retry in 30 seconds",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "retryAfter": 30
}

{
  "type": "https://docs.filmo.io/errors/internal_error",
  "title": "Internal error",
  "status": 500,
  "code": "internal_error",
  "detail": "Internal error",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}

Generated from the schema

A closed ticket is read-only and is rejected; in a partially_converted or fully_invoiced one, the lines already converted to a purchase or an invoice are locked and changes to them are ignored. Behind the incidence add-on. Returns the full repair ticket, the same projection as its GET.

Authorizations

Bearer API key with the scope below. repair-tickets:write

Headers

Idempotency-Keystring

Unique identifier of the request, chosen by the client (a UUID works). Between 1 and 255 characters: an empty header is rejected with 400 validation_error, because the client would believe itself protected. Repeating the same key with the SAME body within 24 h returns the stored response without executing again, with the Idempotent-Replay: true header. With a DIFFERENT body it returns 422. It is the safe way to retry after a network timeout.

Limits: min length 1, max length 255

Example:"9f1c2f4e-3a5b-4f6d-8e7a-0b1c2d3e4f5a"

If-Matchstring

Optimistic locking: the ETag you read from the resource (or *). If the resource changed since, the write is rejected with 412 precondition_failed before doing anything; read it again and retry. Without the header the write always proceeds.

Example:"\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""

Path parameters

ticketIdstringRequired

Repair ticket identifier.

Limits: min length 1

Body

application/json

Body schema: RepairTicketUpdateBody

datestring<date-time>

New date, in ISO 8601 with offset.

statusstring

New repair ticket status.

Available options: draft, sent, partially_converted, fully_invoiced, closed

contactIdstring | null

New client; null unlinks it.

orderIdstring | null

New order; null unlinks it.

projectIdstring | null

New project; null unlinks it.

linesobject[]

COMPLETE set of lines, which replaces the current one. Omit it to leave them untouched.

Show child attributes

lines.idstring

Existing line being modified. Omit it for a new line.

lines.descriptionstringRequired

What needs to be repaired.

Limits: min length 1, max length 500

lines.diagnosisstring

Technical diagnosis.

Limits: max length 5000

lines.entityTypestring | null

Type of element being repaired: item, space or kit. null or omitted for a free line.

Available options: item, space, kit

lines.entityIdstring

Element being repaired.

lines.serializedItemIdstring

Specific physical unit, when a serialized item is repaired.

lines.incidentIdstring

Incident that originates this line.

lines.quantitynumber

Affected units. Defaults to 1.

Limits: min 0

lines.unitPricestring

Net unit price quoted to the client, as a decimal string.

Limits: pattern ^\d{1,13}(\.\d{1,2})?$

lines.notesstring

Line notes.

Limits: max length 2000

notesstring | null

New notes; null clears them.

Limits: max length 5000

Response

application/json

Successful response.

Response schema: RepairTicketDetailDto

Envelope: RepairTicketDetailResponse. meta.warnings is present only when the operation is deprecated.

Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag · Idempotent-Replay

dataobject

Detail of a repair ticket, with its lines.

Show child attributes

data.idstring

Unique ticket identifier.

data.numberstring

Ticket number, for example "RT-2026-0001".

data.datestring<date-time>

Issue date in ISO 8601 UTC.

data.statusstring

Status of the ticket in its lifecycle.

Available options: draft, sent, partially_converted, fully_invoiced, closed

data.orderIdstring | null

Identifier of the order it comes from; null if it was created standalone.

data.orderNumberstring | null

Number of the order it comes from; null if it was created standalone.

data.contactIdstring | null

Identifier of the responsible client; null if none has been assigned.

data.contactNamestring | null

Name of the responsible client; null if not resolved.

data.subTotalstring

Sum of the lines before taxes, as a decimal string "1234.50".

Limits: pattern ^-?\d+\.\d{2}$

data.taxTotalstring

Tax total, as a decimal string "1234.50".

Limits: pattern ^-?\d+\.\d{2}$

data.totalstring

Total including taxes, as a decimal string "1234.50".

Limits: pattern ^-?\d+\.\d{2}$

data.totalLinesinteger

Number of lines in the ticket.

data.notesstring | null

General remarks; null if it has none.

data.createdAtstring<date-time>

Creation date in ISO 8601 UTC.

data.updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

data.projectIdstring | null

Identifier of the associated project; null if it has none.

data.linesobject[]

Ticket lines.

Show child attributes

data.lines.idstring

Unique line identifier.

data.lines.entityTypestring | null

Type of element being repaired: item, serializedItem (a specific unit), space or kit; null for a free line (a service, a charge).

Available options: item, serializedItem, space, kit

data.lines.entityIdstring | null

Identifier of the element being repaired; null if it is a free line.

data.lines.entityNamestring | null

Name of the element being repaired; null if not resolved.

data.lines.descriptionstring

What needs to be repaired.

data.lines.diagnosisstring | null

Technical diagnosis; null if none has been recorded.

data.lines.quantitynumber | null

Affected units; null if not applicable.

data.lines.unitPricestring | null

NET unit price quoted to the client, as a decimal string "1234.50". It is not the repair cost: that one is not published. null if the line has no price.

Limits: pattern ^-?\d+\.\d{2}$

data.lines.incidentIdstring | null

Identifier of the incident that originated this line; null if it does not come from one.

data.lines.notesstring | null

Line notes; null if it has none.

data.sourceIncidentIdsstring[]

Identifiers of the incidents that originated the ticket.

data.customFieldsobject<string, any>

Custom field values by custom field identifier; the definitions are in /api/v1/custom-fields.

metaobject

Additional information about the response.

Show child attributes

meta.warningsobject[]

Lifecycle warnings; present only when the operation is deprecated.

Show child attributes

meta.warnings.codestring

Stable warning code.

Available options: deprecated

meta.warnings.messagestring

For people: what is deprecated, until when, and what to use.

meta.warnings.sunsetstring

Day (YYYY-MM-DD) the operation stops being served.

meta.warnings.replacementstring | null

operationId of the operation to use instead, or null if there is none.

meta.warnings.linkstring

Where the deprecation is documented (the changelog).

Errors

Status	Codes	Meaning
400	`validation_error`	Malformed query or body. `errors[]` lists every offending field with its stable code.
402	`addon_required`	The account plan does not include the add-on this operation needs; `requiredAddon` names it.
404	`not_found`	It does not exist or is outside the scope of the API key.
409	`conflict`	The current state of the resource prevents the operation, a request with that Idempotency-Key is already in progress, or another conditional write (`If-Match`) held the resource for more than five seconds. `errors[0].code` says which: `in_progress` and `lock_timeout` are solved by retrying; `invalid_state` is not, because the state of the resource forbids the operation.
412	`precondition_failed`	The `If-Match` entity tag does not match the current representation. Read the resource again and retry.
422	`idempotency_key_reused`	The same key was used before with a different body. Change the key.

401, 403, 429, 500 can be returned by any operation. Errors

Deprecation

This operation is not deprecated. Deprecations are announced with a Deprecation header and a sunset date. Versioning policy

Operations
Repair ticket
Repair ticket: what broke and what is quoted to fix it.

Was this page helpful?

Request examples

Authorizations

Headers

Path parameters

Body

Response

Errors

Deprecation

Related

Related pages

Repair ticket