Edge

Create an Edge agent execution

Changed on

EDGE-060 — supports Idempotency-Key. A retry with the same key and identical body returns the SAME execution_id (cached replay, 201) without burning against the per-session execution cap. A retry with the same key but different body returns 409 idempotency_conflict. Missing key falls back to non-idempotent behavior (every call generates a fresh execution_id).

post/api/v1/edge/executions

Request

  • Base URL: http://localhost:8081
  • URL: http://localhost:8081/api/v1/edge/executions
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Headers

X-Tenant-IDstring required

Tenant isolation header (required on all protected routes).

Idempotency-Keystring uuid

Optional idempotency key for safe retries. Edge event create/batch scopes keys by tenant and endpoint, replays the first response for the same normalized request, and returns 409 idempotency_conflict if the same key is reused with a different normalized request. Callers SHOULD send a UUID (per the original Job submit contract); the Edge runtime additionally accepts any non-empty string up to 512 bytes for backward-compatible local-dev keys.

Request body

tenant_idstring

Optional body tenant; when present it must match X-Tenant-ID.

session_idstring required
adapter'claude-code-hook' | 'mcp-gateway' | 'llm-proxy' | 'runtime-sidecar' | 'sdk-runner'
mode'local-dev' | 'enterprise-managed' | 'workflow' | 'ci' | 'prod-runner'
workflow_run_idstring
step_idstring
job_idstring
attemptinteger
trace_idstring
worker_idstring
policy_snapshotstring

Redacted policy snapshot identifier or summary; raw secrets are redacted before persistence/response.

labelsEdgeLabels

Response

Edge execution created

execution_idstring required
session_idstring required
tenant_idstring required
adapter'claude-code-hook' | 'mcp-gateway' | 'llm-proxy' | 'runtime-sidecar' | 'sdk-runner' required
mode'local-dev' | 'enterprise-managed' | 'workflow' | 'ci' | 'prod-runner' required
workflow_run_idstring
step_idstring
job_idstring
attemptinteger
trace_idstring
worker_idstring
policy_snapshotstring
status'running' | 'waiting_for_approval' | 'succeeded' | 'failed' | 'cancelled' | 'timeout' | 'degraded' required
started_atstring date-time required
ended_atstring date-time nullable
labelsEdgeLabels

Changes

  • 12120aad0bfeRevision changes
    • warning

      added the new limit_exceeded enum value to the response property for the response status

    • warning

      added the new limit_exceeded enum value to the response property for the response status

    • warning

      added the new limit_exceeded enum value to the response property for the response status

    • warning

      added the new limit_exceeded enum value to the response property for the response status

    • warning

      added the new limit_exceeded enum value to the response property for the response status

    • warning

      added the new limit_exceeded enum value to the response property for the response status

    • warning

      added the new limit_exceeded enum value to the response property for the response status

    • warning

      added the new limit_exceeded enum value to the response property for the response status

    • warning

      added the new replay_window_full enum value to the response property for the response status

    • warning

      added the new replay_window_full enum value to the response property for the response status

    • warning

      added the new replay_window_full enum value to the response property for the response status

    • warning

      added the new replay_window_full enum value to the response property for the response status

    • warning

      added the new replay_window_full enum value to the response property for the response status

    • warning

      added the new replay_window_full enum value to the response property for the response status

    • warning

      added the new replay_window_full enum value to the response property for the response status

    • warning

      added the new replay_window_full enum value to the response property for the response status

    • warning

      added the new step_up_required enum value to the response property for the response status

    • warning

      added the new step_up_required enum value to the response property for the response status

    • warning

      added the new step_up_required enum value to the response property for the response status

    • warning

      added the new step_up_required enum value to the response property for the response status

    • warning

      added the new step_up_required enum value to the response property for the response status

    • warning

      added the new step_up_required enum value to the response property for the response status

    • warning

      added the new step_up_required enum value to the response property for the response status

    • warning

      added the new step_up_required enum value to the response property for the response status

  • 9f66383d6e95Revision changes
    • info

      endpoint added