addy.io Labels API
The Labels API from addy.io — 2 operation(s) for labels.
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/addy-io:addy-io-labels-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
openapi: 3.2.0
info:
title: addy.io API Documentation Labels API
description: ''
version: 1.0.0
servers:
- url: https://app.addy.io
security:
- default: []
tags:
- name: Labels
description: ''
paths:
/api/v1/labels:
get:
summary: Get All Labels
operationId: getAllLabels
description: This endpoint retrieves all labels.
parameters:
- in: query
name: filter[search]
description: Search labels by name.
example: shop
required: false
schema:
type: string
description: Search labels by name.
example: shop
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
200:
description: ''
content:
application/json:
schema:
type: object
example:
data:
- id: 46eebc50-f7f8-46d7-beb9-c37f04c29a84
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
name: shopping
colour: '#06b6d4'
aliases_count: 3
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 09:00:00'
properties:
data:
type: array
example:
- id: 46eebc50-f7f8-46d7-beb9-c37f04c29a84
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
name: shopping
colour: '#06b6d4'
aliases_count: 3
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 09:00:00'
items:
type: object
properties:
id:
type: string
example: 46eebc50-f7f8-46d7-beb9-c37f04c29a84
user_id:
type: string
example: ca0a4e09-c266-4f6f-845c-958db5090f09
name:
type: string
example: shopping
colour:
type: string
example: '#06b6d4'
aliases_count:
type: integer
example: 3
created_at:
type: string
example: '2019-10-01 09:00:00'
updated_at:
type: string
example: '2019-10-01 09:00:00'
tags:
- Labels
post:
summary: Create New Label
operationId: createNewLabel
description: This endpoint creates a new label.
parameters:
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
201:
description: ''
content:
application/json:
schema:
type: object
example:
data:
id: 46eebc50-f7f8-46d7-beb9-c37f04c29a84
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
name: shopping
colour: '#06b6d4'
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 09:00:00'
properties:
data:
type: object
properties:
id:
type: string
example: 46eebc50-f7f8-46d7-beb9-c37f04c29a84
user_id:
type: string
example: ca0a4e09-c266-4f6f-845c-958db5090f09
name:
type: string
example: shopping
colour:
type: string
example: '#06b6d4'
created_at:
type: string
example: '2019-10-01 09:00:00'
updated_at:
type: string
example: '2019-10-01 09:00:00'
tags:
- Labels
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: The name of the label
example: Shopping
colour:
type: string
description: 'The colour of the label. Must be one of: #06b6d4, #22c55e, #eab308, #f97316, #ef4444, #8b5cf6, #64748b, #ec4899, #14b8a6, #3b82f6'
example: '#06b6d4'
required:
- name
- colour
/api/v1/labels/{id}:
parameters:
- in: path
name: id
description: The id of the label to retrieve
example: 50c9e585-e7f5-41c4-9016-9014c15454bc
required: true
schema:
type: string
get:
summary: Get a Specific Label
operationId: getASpecificLabel
description: This endpoint retrieves a specific label.
parameters:
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
200:
description: ''
content:
application/json:
schema:
type: object
example:
data:
id: 46eebc50-f7f8-46d7-beb9-c37f04c29a84
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
name: shopping
colour: '#06b6d4'
aliases_count: 3
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 09:00:00'
properties:
data:
type: object
properties:
id:
type: string
example: 46eebc50-f7f8-46d7-beb9-c37f04c29a84
user_id:
type: string
example: ca0a4e09-c266-4f6f-845c-958db5090f09
name:
type: string
example: shopping
colour:
type: string
example: '#06b6d4'
aliases_count:
type: integer
example: 3
created_at:
type: string
example: '2019-10-01 09:00:00'
updated_at:
type: string
example: '2019-10-01 09:00:00'
tags:
- Labels
patch:
summary: Update a Specific Label
operationId: updateASpecificLabel
description: This endpoint updates a specific label.
parameters:
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
200:
description: ''
content:
application/json:
schema:
type: object
example:
data:
id: 46eebc50-f7f8-46d7-beb9-c37f04c29a84
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
name: work
colour: '#22c55e'
aliases_count: 3
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 10:00:00'
properties:
data:
type: object
properties:
id:
type: string
example: 46eebc50-f7f8-46d7-beb9-c37f04c29a84
user_id:
type: string
example: ca0a4e09-c266-4f6f-845c-958db5090f09
name:
type: string
example: work
colour:
type: string
example: '#22c55e'
aliases_count:
type: integer
example: 3
created_at:
type: string
example: '2019-10-01 09:00:00'
updated_at:
type: string
example: '2019-10-01 10:00:00'
tags:
- Labels
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: The name of the label
example: Shopping
colour:
type: string
description: 'The colour of the label. Must be one of: #06b6d4, #22c55e, #eab308, #f97316, #ef4444, #8b5cf6, #64748b, #ec4899, #14b8a6, #3b82f6'
example: '#22c55e'
delete:
summary: Delete a Specific Label
operationId: deleteASpecificLabel
description: This endpoint deletes a specific label.
parameters:
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
204:
description: ''
content:
application/json:
schema:
type: object
example: {}
properties: {}
tags:
- Labels
components:
securitySchemes:
default:
type: http
scheme: bearer
description: You can retrieve your API key by visiting your <a href="https://app.addy.io/settings/api">account settings</a> and clicking <b>Create New API Key</b>.