tags API · Marula PSA docs

API reference

7 operations in tags. Raw spec: openapi.json.

GET/api/v1/tags

GET /api/tags — the org's tag taxonomy with application counts.

Responses

Status	Description
`200`

Security: bearer

POST/api/v1/tags

POST /api/tags — create a tag.

Request body

CreateTagRequest

Responses

Status	Description
`200`
`409`	duplicate tag name or idempotency key reused

Security: bearer

PATCH/api/v1/tags/{id}

PATCH /api/tags/{id} — rename / recolor.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes

Request body

UpdateTagRequest

Responses

Status	Description
`200`
`404`	tag not found
`409`	version conflict or duplicate name

Security: bearer

DELETE/api/v1/tags/{id}

DELETE /api/tags/{id} — removes the tag and every ticket application.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes

Responses

Status	Description
`200`
`404`	tag not found

Security: bearer

GET/api/v1/tickets/{id}/tags

GET /api/tickets/{id}/tags — the ticket's applied tags.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes

Responses

Status	Description
`200`

Security: bearer

POST/api/v1/tickets/{id}/tags

POST /api/tickets/{id}/tags — apply a tag to a ticket (idempotent).

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes

Request body

ApplyTagRequest

Responses

Status	Description
`200`
`404`	ticket or tag not found
`409`	idempotency key reused

Security: bearer

DELETE/api/v1/tickets/{id}/tags/{tag_id}

DELETE /api/tickets/{id}/tags/{tag_id} — remove one applied tag.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes
`tag_id`	path	string	Yes

Responses

Status	Description
`200`
`404`	ticket or tag not in scope

Security: bearer