Tags

Operations about tags

Retrieve all tags

get

Retrieve all tags from your instance.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Query parameters

limitnumber · max: 250Optional

The maximum number of items to return.

Default: 100Example: 100

cursorstringOptional

Paginate by setting the cursor parameter to the nextCursor attribute returned by the previous request's response. Default value fetches the first "page" of the collection. See pagination for more detail.

Responses

200

Operation successful.

application/json

nextCursorstring · nullableOptional

Paginate through tags by setting the cursor parameter to a nextCursor attribute returned by a previous request. Default value fetches the first "page" of the collection.

Example: MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA

401

Unauthorized

get/tags

HTTPcURLJavaScriptPython

GET /api/v1/tags HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": "2tUt1wbLX592XDdX",
      "name": "Production",
      "createdAt": "2026-07-19T15:39:55.846Z",
      "updatedAt": "2026-07-19T15:39:55.846Z"
    }
  ],
  "nextCursor": "MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA"
}

Create a tag

post

Create a tag in your instance.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Body

application/json

idstringRead-onlyOptionalExample: 2tUt1wbLX592XDdX

namestringRequiredExample: Production

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

Responses

201

A tag object

application/json

idstringRead-onlyOptionalExample: 2tUt1wbLX592XDdX

namestringRequiredExample: Production

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

400

The request is invalid or provides malformed data.

401

Unauthorized

409

Conflict

post/tags

HTTPcURLJavaScriptPython

POST /api/v1/tags HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "name": "Production"
}

{
  "id": "2tUt1wbLX592XDdX",
  "name": "Production",
  "createdAt": "2026-07-19T15:39:55.846Z",
  "updatedAt": "2026-07-19T15:39:55.846Z"
}

Retrieves a tag

get

Retrieves a tag.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Path parameters

idstringRequired

The ID of the tag.

Responses

200

Operation successful.

application/json

idstringRead-onlyOptionalExample: 2tUt1wbLX592XDdX

namestringRequiredExample: Production

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

401

Unauthorized

404

The specified resource was not found.

get/tags/{id}

HTTPcURLJavaScriptPython

GET /api/v1/tags/{id} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

{
  "id": "2tUt1wbLX592XDdX",
  "name": "Production",
  "createdAt": "2026-07-19T15:39:55.846Z",
  "updatedAt": "2026-07-19T15:39:55.846Z"
}

Update a tag

put

Update a tag.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Path parameters

idstringRequired

The ID of the tag.

Body

application/json

idstringRead-onlyOptionalExample: 2tUt1wbLX592XDdX

namestringRequiredExample: Production

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

Responses

200

Tag object

application/json

idstringRead-onlyOptionalExample: 2tUt1wbLX592XDdX

namestringRequiredExample: Production

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

400

The request is invalid or provides malformed data.

401

Unauthorized

404

The specified resource was not found.

409

Conflict

put/tags/{id}

HTTPcURLJavaScriptPython

PUT /api/v1/tags/{id} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "name": "Production"
}

{
  "id": "2tUt1wbLX592XDdX",
  "name": "Production",
  "createdAt": "2026-07-19T15:39:55.846Z",
  "updatedAt": "2026-07-19T15:39:55.846Z"
}

Delete a tag

delete

Deletes a tag.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Path parameters

idstringRequired

The ID of the tag.

Responses

200

Operation successful.

application/json

idstringRead-onlyOptionalExample: 2tUt1wbLX592XDdX

namestringRequiredExample: Production

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

401

Unauthorized

403

Forbidden

404

The specified resource was not found.

delete/tags/{id}

HTTPcURLJavaScriptPython

DELETE /api/v1/tags/{id} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

{
  "id": "2tUt1wbLX592XDdX",
  "name": "Production",
  "createdAt": "2026-07-19T15:39:55.846Z",
  "updatedAt": "2026-07-19T15:39:55.846Z"
}