Skip to content
Hexel StudioDocs

Apply a spec bundle as the agent's next version

POST/harness/agents/{name}/versions

Creates the agent on its first apply. Applying the latest version's digest again is a no-op (200, created: false). ?promote=<channel> also points the channel at the new version alone (needs harness:agent:promote). An invalid bundle is 422 invalid_bundle with details.problems.

Query parameters

promoteoptional string

A channel to point at the version (lowercase letters, digits and hyphens).

Headers

Bearer <token>. A Hexel Studio access token for your organization.

The workspace the request acts in (ws_...). It never grants access by itself.

The environment the request acts in (env_...). It never grants access by itself.

Body parameters

namestring
modelstring
instructionsoptional string
toolsoptional array of string
skillsoptional array of string
budgetsoptional object

Returns

200The latest version already had this bundle.ApplyResult

agentAgent
createdboolean
versionVersion

Errors

  • default