Skip to main content
POST
/
v1
/
execute
Execute a tool on behalf of an external agent
curl --request POST \
  --url https://api.usezombie.com/v1/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target": "<string>",
  "method": "GET",
  "credential_ref": "<string>",
  "body": "<string>"
}
'
{
  "status": 123,
  "body": "<string>",
  "usezombie": {
    "action_id": "<string>",
    "firewall_decision": "allow",
    "credential_injected": true,
    "approval_required": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.usezombie.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Body

application/json
​
target
string<uri>
required

Target URL for the outbound call.

​
method
enum<string>
required

HTTP method to use against the target.

Available options:
GET,
POST,
PUT,
PATCH,
DELETE
​
credential_ref
string
required

Named credential from the workspace vault to inject on the outbound request.

​
body
string | null

Request body to forward to the target. Null for GET/DELETE.

Response

Tool executed; upstream status and body are returned plus UseZombie metadata.

​
status
integer
required

HTTP status returned by the upstream target.

​
body
string
required

Response body returned by the upstream target (as string).

​
usezombie
object
required