Exchange an Automation Secret
Exchange an automation secret for an access token.
Exchange the automation secret for an access token before calling scoped workspace APIs.
- Use the right credential in the right place.
- Mint a short-lived access token safely.
- Know when to repeat the exchange.
Where this happens
Same Task, Other Interfaces
Use the version that matches where you are working now. The subject matter stays the same; the delivery changes by surface.
Keep this boundary clear
- The long-lived automation secret is not the token you should keep reusing on normal resource endpoints.
Do the work
- 1. Send the long-lived automation secret as the bearer token in the `Authorization` header.
- 2. Read the returned short-lived access token and expiry timestamp.
- 3. Use the short-lived access token on resource endpoints such as `/api/v1/workspaces/{workspaceId}/tasks` or `/api/v1/workspaces/{workspaceId}/projects`.
- 4. Repeat the exchange when the short-lived token expires.
Exchange an automation secret
curl -X POST http://localhost:5173/api/v1/automation-auth/exchange -H 'authorization: Bearer blg_auto_secret_here'Keep Going in Automation and Agents
Stay in the same interface and move to the next closest task in this topic when needed.
List Automations
Review the current workspace automations before you create, update, or rotate one.
Create an Automation
Create the workspace automation boundary, issue the automation secret, and store that secret safely because it is only shown once.
Update an Automation
Change automation metadata, team boundaries, scopes, or suspension state without recreating the automation.
Rotate an Automation Secret
Issue a new automation secret when the old one should no longer be trusted, then replace it everywhere the old secret was used.
List Visible Agents
Review the current visible agent bindings before creating a new agent or editing an existing one.
Create a Visible Agent
Create a named visible agent under an existing installation so activity, assignees, and attribution can point to a meaningful product actor.
Update a Visible Agent
Change a visible agent name, team scope, role, or suspension state without recreating the binding.
Nearby Guides
These guides stay close to the current workflow so you can keep moving without restarting discovery.