Tag files

View as Markdown

Adds a tag label to a batch of files (idempotent per file). The body carries fileIds and the label. Requires file:write on the project.

Authentication

AuthorizationBearer

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

Path parameters

projectIdstringRequired

Request

This endpoint expects an object.
fileIdslist of stringsRequired
The file ids to tag.
labelstringRequired
The tag label to add.

Response

The tagged files.
fileslist of objects

Errors

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