Skip to navigation
API ReferenceAssets

Publish a skill or collab agent

Beta

Publish a skill or collab agent so it is live for everyone who uses it. Omit version_id to snapshot and publish the current draft, or pass an existing version to promote it. Requires edit access to the asset.

Authentication

X-API-KEYstring
API Key authentication via header

Path parameters

asset_idstringRequired
ID of the skill or collab agent to publish

Headers

X-Athena-Session-CredentialstringOptional

Request

This endpoint expects an object.
notestring or nullOptional
Optional release note shown in the publish history
version_idstring or nullOptional
Existing version to promote to published. Omit to snapshot and publish the current draft.

Response

Successful Response
asset_idstring
ID of the published asset
asset_typestring
Type of the published asset
publishedboolean
Always true on success
titlestring
Title of the published asset

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error