Add a tag to a file

View as Markdown

Adds a tag label to a single file (idempotent). The label is applied verbatim (lowercased) and need not exist in the org tag library. Requires file:write on the project.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Path parameters

projectIdstringRequired
fileIdstringRequired

Request

This endpoint expects an object.
labelstringRequired
The tag label to add.

Response

The tagged file.
fileobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error