Escape Tags API
Manage tags. The public API provides basic CRUDs operations to manage tags.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/escape:escape-tags-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Escape Tags API
version: 3.0.0
description: 'Operations tagged Tags across 2 of this provider''s published API definitions: escape-openapi.json, escape-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://public.escape.tech/v3
security:
- apiKey: []
tags:
- name: Tags
description: 'Manage tags.
The public API provides basic CRUDs operations to manage tags.'
paths:
/tags:
get:
tags:
- Tags
summary: List tags
operationId: listTags
description: 'List and search tags of the organization. Pass `cursor` and `size` to page through the tags: without them every tag is returned, as before.'
parameters:
- schema:
type: string
description: The cursor to start the pagination from. Returned by the previous page response. If not provided, the first page will be returned.
example: R1BDOlM6NTEwMzk4NTYtNGIyOS00NTlkLTg0ZDYtMWJhYjM0NWMzZjU5
required: false
description: The cursor to start the pagination from. Returned by the previous page response. If not provided, the first page will be returned.
name: cursor
in: query
- schema:
type: integer
minimum: 1
maximum: 100
default: 50
description: The number of items to return per page
example: 50
required: false
description: The number of items to return per page
name: size
in: query
responses:
'200':
description: OK
headers:
X-Next-Cursor:
schema:
type: string
description: Cursor to pass as the `cursor` query parameter to fetch the next page. Absent when there is no next page.
required: false
description: Cursor to pass as the `cursor` query parameter to fetch the next page. Absent when there is no next page.
content:
application/json:
schema:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: The id of the tag
name:
type: string
description: The name of the tag
color:
type: string
description: The color of the tag
required:
- id
- name
- color
title: TagDetail
description: Detailed information about a tag
'400':
description: Pagination error
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Invalid cursor
- Branch filters page limit reached
details:
type: string
required:
- message
- details
title: PaginationError
description: Returned when an invalid pagination cursor is supplied or when the branch filters page limit is reached
post:
tags:
- Tags
summary: Create a tag
operationId: createTag
description: Create a tag for the organization.
requestBody:
description: Body of the request to create a tag
content:
application/json:
schema:
type: object
properties:
name:
type: string
maxLength: 40
description: The name of the tag
example: tag1
color:
type: string
description: The color of the tag (hexadecimal color code)
example: '000000'
required:
- name
- color
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
description: The id of the tag
name:
type: string
description: The name of the tag
color:
type: string
description: The color of the tag
required:
- id
- name
- color
'400':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Bad Request
details:
type: string
required:
- message
- details
title: BadRequest
description: Returned when the request payload fails validation
servers:
- url: https://public.escape.tech/v3
/tags/{tagId}:
get:
tags:
- Tags
summary: Get a tag
operationId: getTag
description: Get a tag by ID.
parameters:
- schema:
type: string
format: uuid
description: The tag ID
example: 00000000-0000-0000-0000-000000000000
required: true
description: The tag ID
name: tagId
in: path
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
description: The id of the tag
name:
type: string
description: The name of the tag
color:
type: string
description: The color of the tag
required:
- id
- name
- color
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Not found
required:
- message
title: NotFound
description: Returned when the requested resource does not exist
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Internal Server Error
details:
type: string
required:
- message
- details
title: InternalServerError
description: Returned when the server fails to fulfil the request
put:
tags:
- Tags
summary: Update a tag
operationId: updateTag
description: Update a tag name and/or color.
parameters:
- schema:
type: string
format: uuid
description: The tag ID
example: 00000000-0000-0000-0000-000000000000
required: true
description: The tag ID
name: tagId
in: path
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
maxLength: 40
description: The new name of the tag
example: production
color:
type: string
pattern: ^[\da-f]{6}$/i
description: 'The new color of the tag (hex without #)'
example: e03d3d
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
description: The id of the tag
name:
type: string
description: The name of the tag
color:
type: string
description: The color of the tag
required:
- id
- name
- color
'400':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Bad Request
details:
type: string
required:
- message
- details
title: BadRequest
description: Returned when the request payload fails validation
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Not found
required:
- message
title: NotFound
description: Returned when the requested resource does not exist
delete:
tags:
- Tags
summary: Delete a tag
operationId: deleteTag
description: Delete a tag from the organization.
parameters:
- schema:
type: string
format: uuid
description: The tag ID
example: 00000000-0000-0000-0000-000000000000
required: true
description: The tag ID
name: tagId
in: path
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
message:
type: string
required:
- message
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Not found
required:
- message
title: NotFound
description: Returned when the requested resource does not exist
'409':
description: Tag is bound and cannot be deleted
content:
application/json:
schema:
type: object
properties:
message:
type: string
required:
- message
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Internal Server Error
details:
type: string
required:
- message
- details
title: InternalServerError
description: Returned when the server fails to fulfil the request
servers:
- url: https://public.escape.tech/v3
/tags/{tagId}/{tagId}:
put:
tags:
- Tags
summary: Update a tag
operationId: putTagsByTagIdByTagId
description: Update a tag name and/or color.
parameters:
- schema:
type: string
format: uuid
description: The tag ID
example: 00000000-0000-0000-0000-000000000000
required: true
description: The tag ID
name: tagId
in: path
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
maxLength: 40
description: The new name of the tag
example: production
color:
type: string
pattern: ^[\da-f]{6}$/i
description: 'The new color of the tag (hex without #)'
example: e03d3d
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
description: The id of the tag
name:
type: string
description: The name of the tag
color:
type: string
description: The color of the tag
required:
- id
- name
- color
'400':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Bad Request
details:
type: string
required:
- message
- details
title: BadRequest
description: Returned when the request payload fails validation
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
enum:
- Not found
required:
- message
title: NotFound
description: Returned when the requested resource does not exist
x-operation-id-source: normalized
x-operation-id-original: updateTag
servers:
- url: https://public.escape.tech/v3
components:
securitySchemes:
apiKey:
type: apiKey
in: header
name: X-ESCAPE-API-KEY
x-refined-from:
- escape-openapi.json
- escape-openapi.yml