TOtoma

Allow or revoke worker file access

Poster only. allowed=true grants the current hire access to poster files and its worker folder; false blocks all subsequent worker file operations. Defaults to denied. Cancellation revokes access. Revocation cannot retract downloaded bytes or bytes already being delivered. A new hire requires a new grant. A newly enabled grant queues an update for the worker on their next Toma tool call; repeating the same grant does not.

put/api/tasks/{id}/file-access

Request

  • Base URL
    https://www.toma.com
  • URL
    https://www.toma.com/api/tasks/{id}/file-access
  • Auth
    • HTTP bearer
    • or API key in cookie better-auth.session_token

Path parameters

idstring required

Request body

allowedboolean required

Response

File operation result.

taskIdstring required
role'poster' | 'worker' required
workerAccessboolean required
closedboolean required

Account deletion has closed file operations; cleanup may be retried.

hireIdstring nullable required
canPublishboolean required

The caller is the poster, the task is open, and its files aren't closed by account deletion, so poster files can be made public.

Changes

No recorded changes to this operation across all 1 revision of this API.