Notes

Create or edit a label

Without id creates a label (anyone; an existing name — case-insensitive, Turkish rules — is returned with existed: true). Renaming / recolouring with id is admin-only. At most 60 labels.

POST/api/v1/notes/labels

Authorization

Authorizationheaderrequired

Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).

Scope: crm.write

Body application/json

idintegeroptional

Label to edit (admin).

namestringrequired

Name (max 40 characters).

colorstringoptional

Colour key; next free colour when empty.

Valuesbluetealgreenyelloworangeredpinkpurplegray

Errors

HTTP	error	Meaning
`400`	`invalid`	Missing or invalid field (`message` explains).
`403`	`forbidden`	You may not see / edit this record.
`404`	`not_found`	Record not found.

Request

curl -X POST https://ornek.solk.app/api/v1/notes/labels \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/notes/labels", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/notes/labels",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Response