Promote an agent version
Select an immutable version for future Tasks. When approval is required, a person must promote it or answer the stored Task approval request.
Authentication
AuthorizationBearer
Use Bearer <api-key>.
Path parameters
agentId
version
Headers
BCTRL-Version
Dated API version. Defaults to the release pinned when the API key was created.
Allowed values:
BCTRL-Space
Select one authorized Space by its opaque ID or unique name. Omission uses the operation default.
BCTRL-Subaccount-Id
Optional effective subaccount context for organization API keys. Subaccount API keys are already scoped and cannot use this header to act as another subaccount.
Idempotency-Key
Optional retry key for this billable operation. Reusing the same key with the same request replays its stable outcome; credential-bearing results may be freshly issued for the same principal. Reusing it with a different request returns 409.
Request
This endpoint expects an object.
Response headers
BCTRL-Request-Id
Current request identifier, also echoed in errors.
BCTRL-Version
Negotiated dated API version.
RateLimit-Limit
Evaluated policy limit; zero when no finite policy was evaluated.
RateLimit-Remaining
Remaining policy budget; zero when no finite policy was evaluated.
RateLimit-Reset
Seconds until reset; zero when no finite policy was evaluated.
Response
OK
createdAt
RFC 3339 timestamp with a UTC offset.
id
Unique agent identifier generated by BCTRL.
latestVersion
metadata
name
Customer-facing resource name. 1–200 characters.
object
promotedVersion
spaceId
Unique space identifier generated by BCTRL.
updatedAt
RFC 3339 timestamp with a UTC offset.
version
Errors
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error