Skip to navigation
API v1 ReferenceAgent Skills

Stores an uploaded file as a bundled skill file.

Stores or replaces a bundled file from an upload ID or temporary file ID. The relative path defaults to fileName and can be overridden with relativePath, for example references/logo.png. The same file, count, and package limits apply as for the multipart upload.

Required Permissions
Any authenticated user.

Authentication

AuthorizationBearer

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

Path parameters

skillIdstringRequiredformat: "uuid"
The skill ID.

Request

The upload ID and target path.
uploadIdstringRequiredformat: "uuid"
The upload ID from generateUploadUrl or an existing temporary file ID.
fileNamestringRequired1-400 characters
The uploaded file name. It is the target path unless AiService.Feature.AgentRuntime.Models.UploadSkillFileByUploadIdRequestModel.RelativePath is set.
relativePathstring or nullOptional<=400 characters
The optional target path relative to the skill root. Defaults to the file name.

Response

OK
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