Nurama Developers
Tags

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`).

POST
/tags

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).

Authorization

AuthorizationBearer <token>

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}