Files

Upload files to an agent. Requires files scope.

Upload a file to an agent

post

Uploads a file to the agent's knowledge base. Requires files scope. The agent must be running.

Authorizations

AuthorizationstringRequired

API key sent as Bearer token. Two types:

• Master key (g_master_...): full access to all agents and endpoints.
• Agent key (g_agent_...): scoped to a single agent with specific permissions.

Path parameters

idstring · uuidRequired

Body

filenamestring · max: 255Required

contentstringRequired

mimeTypestring · max: 100Required

Responses

200

File uploaded

No content

401

Unauthorized — Invalid or missing API key

application/json

403

Forbidden — Key lacks the required scope

application/json

post/agents/{id}/files

POST /api/v1/agents/{id}/files HTTP/1.1
Host: api.guayaba.run
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "filename": "text",
  "content": "text",
  "mimeType": "text"
}

No content