Escape Tags API

Manage tags. The public API provides basic CRUDs operations to manage tags.

Operations 5

GET /tags List tags #
POST /tags Create a tag #
GET /tags/{tagId} Get a tag #
DELETE /tags/{tagId} Delete a tag #
PUT /tags/{tagId}/{tagId} Update a tag #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/escape-tags-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

escape-tags-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: 3.0.0
  title: Escape Public Asm Tags API
  description: 'This API enables you to operate [Escape](https://escape.tech/) programmatically.


    All requests must be authenticated with a valid API key, provided in the `X-ESCAPE-API-KEY` header.

    For example: `X-ESCAPE-API-KEY: YOUR_API_KEY`.


    You can find your API key in the [Escape dashboard](https://app.escape.tech/user/).'
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.
      responses:
        '200':
          description: OK
          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
                  details:
                    type: string
                required:
                - message
                - details
                title: PaginationError
                description: Returned when an invalid pagination cursor is supplied
    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
  /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
    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
  /tags/{tagId}/{tagId}:
    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
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-ESCAPE-API-KEY