Tags

Get all tags

get

Returns all tags for the organization.

Rate limit: 60 requests per minute

Authorizations

AuthorizationstringRequired

Authorization: Bearer

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400

The request was invalid or could not be completed.

application/json

404Error

application/json

500

An unexpected internal error occurred.

application/json

get/tags

GET /tags HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "hex_color": "text",
      "id": "text",
      "object_type": "issue",
      "value": "text"
    }
  ],
  "pagination": {
    "cursor": "text",
    "has_next_page": true
  },
  "request_id": "text"
}

Get a tag by its ID

get

Returns a single tag by ID.

Rate limit: 60 requests per minute

Authorizations

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID of the tag.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400

The request was invalid or could not be completed.

application/json

404Error

application/json

500

An unexpected internal error occurred.

application/json

get/tags/{id}

GET /tags/{id} HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": {
    "hex_color": "text",
    "id": "text",
    "object_type": "issue",
    "value": "text"
  },
  "request_id": "text"
}

Create a new tag

post

Creates a new tag with the specified value and object type.

Rate limit: 60 requests per minute

Authorizations

AuthorizationstringRequired

Authorization: Bearer

Body

hex_colorstringOptional

The hex code of the tag's color.

object_typestring · enumRequired

The object type of the associated object. Can be "account", "article", or "issue".

Example: issuePossible values:

valuestringRequired

The tag value.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400

The request was invalid or could not be completed.

application/json

404Error

application/json

409Error

application/json

500

An unexpected internal error occurred.

application/json

post/tags

POST /tags HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "hex_color": "text",
  "object_type": "issue",
  "value": "text"
}

{
  "data": {
    "hex_color": "text",
    "id": "text",
    "object_type": "issue",
    "value": "text"
  },
  "request_id": "text"
}

Update an existing tag

patch

Updates an existing tag. Only provided fields are modified.

Rate limit: 10 requests per minute

Authorizations

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID of the tag to update.

Body

hex_colorstringOptional

The hex code of the tag's color.

valuestringOptional

in: body The name of the tag.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400

The request was invalid or could not be completed.

application/json

404Error

application/json

500

An unexpected internal error occurred.

application/json

patch/tags/{id}

PATCH /tags/{id} HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "hex_color": "text",
  "value": "text"
}

{
  "data": {
    "hex_color": "text",
    "id": "text",
    "object_type": "issue",
    "value": "text"
  },
  "request_id": "text"
}

Delete an existing tag

delete

Permanently deletes a tag by ID.

Rate limit: 10 requests per minute

Authorizations

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID of the tag to update.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400

The request was invalid or could not be completed.

application/json

404Error

application/json

500

An unexpected internal error occurred.

application/json

delete/tags/{id}

DELETE /tags/{id} HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "request_id": "text"
}