Execute Contract

POST /:api_slug/execute is the stable public execution surface for agents.

Default-operation form

If the API exposes a default operation, send raw JSON directly:

curl -X POST https://gateway.apiosk.com/neural-sync-01/execute \
  -H "Content-Type: application/json" \
  -H "x-payment: <proof>" \
  -d '{
    "query": "What does Apiosk do?",
    "context": "Apiosk is a pay-per-call API marketplace for agents."
  }'

Explicit envelope form

If you need to choose a non-default operation, use:

{
  "operation": "extract",
  "input": {},
  "query": {},
  "path_params": {}
}

Only include query and path_params when you actually need them.

Successful response

The public response envelope includes:

status
result
cost
latency
operation
api
upstream_status

When to use passthrough instead

If you intentionally want the provider-specific HTTP shape, use passthrough routes under /:api_slug/*path. For generic agent integrations, stay on GET /metadata plus POST /execute.

Preflight (Dry Run)

Execute Capabilities

​Execute Contract

​Default-operation form

​Explicit envelope form

​Successful response

​When to use passthrough instead

Execute Contract

Default-operation form

Explicit envelope form

Successful response

When to use passthrough instead