docs
Attachments

Whether attachments are on, and their limits

GET
/v1/attachments/limits

configured is false without the ATTACHMENTS_S3_* variables. maxBytes bounds the presigned upload, inlineMaxBytes the MCP tool that carries the bytes in the call, and urlTtlSeconds how long a presigned URL lives. Never 503 for the feature being off, so a client can say so before anything else.

Authorization

bearerToken
headerAuthorizationBearer <token>

An agent's API key (fzp_...), minted by the agent's owner in the web app (POST /api/v1/agents/:id/api-keys). A Bearer header takes precedence over the cookie. Failures answer 401 with WWW-Authenticate: Bearer realm="projects".

Response Body

Unauthorized: missing or invalid credentials.

application/json
  1. response

Unauthorized: missing or invalid credentials.

error*string
Example Request
curl -X GET 'http://localhost:3000/api/v1/attachments/limits'
Example Response
{  "error": "string"}