Create a new tag
Creates a new project-scoped tag. Tags can then be applied to the project's assets, folders, submissions, boards and tasks via their `/tag` endpoints. Requires `canCreateTag` on `ownerResourceId`. Currently only `ownerResourceType: project` is accepted. Tag names must be unique per owner (400 `tagSlugExists`).
Creates a new project-scoped tag. Tags can then be applied to the project's assets, folders, submissions, boards and tasks via their /tag endpoints. Requires canCreateTag on ownerResourceId. Currently only ownerResourceType: project is accepted. Tag names must be unique per owner (400 tagSlugExists).
OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.
In: header
Scope: assets:write
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/tags" \ -H "Content-Type: application/json" \ -d '{ "name": "In Review", "ownerResourceType": "project", "ownerResourceId": "65af4c7b22ac19c0b1648241", "color": "#FF5722" }'{ "id": "65af4c7b22ac19c0b1648555", "name": "High Priority", "slug": "high-priority", "ownerResourceType": "project", "ownerResourceId": "65af4c7b22ac19c0b1648241", "color": "#FF5722", "createdAt": 1678886400000, "updatedAt": 1678886400000}