Labels
Create a label
POST
/labelsCreates a manual label. For a label applied automatically by the AI, create a rule on /ai-label-rules instead.
Authorization
apiKey AuthorizationBearer <token>
Send your key as Authorization: Bearer mk_…. Session cookies are never accepted on this surface.
In: header
Header Parameters
Idempotency-Key?string
A unique value per operation, such as a UUID. Replays the stored response for 24h. Reusing a key with a different body returns 409.
Length
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/labels" \ -H "Authorization: Bearer $MAYLEE_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "color": "Green", "name": "Quotes" }'{ "label": { "color": "Green", "createdAt": "2026-06-02T09:20:00.000Z", "id": "cmtg1a2b3c4d5e6f7g8h9i0j", "isAiLabel": false, "name": "Quotes" }}