Uploads a skill file.

POST

https://api.awork.com/api/v1/agents/skills/:skillId/files

Uploads or replaces a bundled file. The relative path defaults to the uploaded file name and can be overridden with the relativePath query parameter, for example scripts/sync.py.

Required Permissions

Any authenticated user.

Uploads or replaces a bundled file. The relative path defaults to the uploaded file name and can be overridden with the relativePath query parameter, for example scripts/sync.py. <Check title="Required Permissions" icon="key">Any authenticated user.</Check>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

skillIdstringRequiredformat: "uuid"

The skill ID.

Query parameters

relativePathstringOptionalDefaults to

The optional target path relative to the skill root.

Request

This endpoint expects a multipart form containing a file.

filefileRequired

The bundled skill file to upload.

Response

relativePathstring or nullOptional

The path of the file relative to the skill root (for example “scripts/sync.py”).

sizeByteslongOptional

The file size in bytes.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error