Get execution status

GET /api/v1/projects/{id}/executions/{execution_id}

Retrieves execution status by ID. The project scope is carried by the route id path parameter and the org is derived from that project.

Path parameters

id string Required

Project ID
execution_id string Required

Execution ID

Query parameters

workspace_id string

Workspace ID for workspace resolution

Responses

406

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.
Hide response attributes Show response attributes object
- badRequestDetail object
  
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.
  
  Hide badRequestDetail attribute Show badRequestDetail attribute object
  
  fields array[object]
  
  Fields with validation failures.
  
  Hide fields attributes Show fields attributes object
  
  A field and its validation failure.
  
  description string Required
  
  Human-readable validation failure.
  
  field string Required
  
  Name or path of the invalid request field.
- detail string Required
  
  Human-readable error details.
- error integer Required
  
  HTTP status code.
- errorCode string Required
  
  Machine-readable error code.
- parameters array[string]
  
  Request parameter names associated with the error; omitted when none apply.
- reason string Required
  
  HTTP status reason phrase.
Hide response attributes Show response attributes object
- badRequestDetail object
  
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.
  
  Hide badRequestDetail attribute Show badRequestDetail attribute object
  
  fields array[object]
  
  Fields with validation failures.
  
  Hide fields attributes Show fields attributes object
  
  A field and its validation failure.
  
  description string Required
  
  Human-readable validation failure.
  
  field string Required
  
  Name or path of the invalid request field.
- detail string Required
  
  Human-readable error details.
- error integer Required
  
  HTTP status code.
- errorCode string Required
  
  Machine-readable error code.
- parameters array[string]
  
  Request parameter names associated with the error; omitted when none apply.
- reason string Required
  
  HTTP status reason phrase.
200

application/vnd.agent-engine-2026-09-20-preview+json

application/vnd.agent-engine-2026-09-20-preview+json application/json

OK
Hide response attributes Show response attributes object
- error string
- execution object
  
  Hide execution attributes Show execution attributes object
  
  created_at string
  
  error string
  
  error_code string
  
  ErrorCode mirrors the OE's Execution.ErrorCode. Empty for an execution that never errored, or an older OE record predating this field.
  
  execution_id string
  
  message string
  
  org_id string
  
  project_id string
  
  session_id string
  
  startup_failure object
  
  Hide startup_failure attributes Show startup_failure attributes object
  
  boot_id string
  
  code string
  
  component string
  
  phase string
  
  source string
  
  status string
  
  "pending", "running", "suspended", "resuming", "completed", "error", "cancelled"
  
  suspend_context object
  
  Additional properties are allowed.
  
  suspend_reason string
  
  updated_at string
  
  user_id string
- success boolean
Hide response attributes Show response attributes object
- error string
- execution object
  
  Hide execution attributes Show execution attributes object
  
  created_at string
  
  error string
  
  error_code string
  
  ErrorCode mirrors the OE's Execution.ErrorCode. Empty for an execution that never errored, or an older OE record predating this field.
  
  execution_id string
  
  message string
  
  org_id string
  
  project_id string
  
  session_id string
  
  startup_failure object
  
  Hide startup_failure attributes Show startup_failure attributes object
  
  boot_id string
  
  code string
  
  component string
  
  phase string
  
  source string
  
  status string
  
  "pending", "running", "suspended", "resuming", "completed", "error", "cancelled"
  
  suspend_context object
  
  Additional properties are allowed.
  
  suspend_reason string
  
  updated_at string
  
  user_id string
- success boolean
400

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Bad Request
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
401

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Unauthorized
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
404

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Not Found
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
500

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Internal Server Error
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
502

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Bad Gateway
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
Hide response attributes Show response attributes object
- code string
- error string
- success boolean

GET /api/v1/projects/{id}/executions/{execution_id}

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/executions/{execution_id}' \
 --header "Authorization: $API_KEY"

Response examples (406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

Response examples (406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

Response examples (200)

{
  "error": "string",
  "execution": {
    "created_at": "string",
    "error": "string",
    "error_code": "string",
    "execution_id": "string",
    "message": "string",
    "org_id": "string",
    "project_id": "string",
    "session_id": "string",
    "startup_failure": {
      "boot_id": "string",
      "code": "string",
      "component": "string",
      "phase": "string",
      "source": "string"
    },
    "status": "string",
    "suspend_context": {},
    "suspend_reason": "string",
    "updated_at": "string",
    "user_id": "string"
  },
  "success": true
}

Response examples (200)

{
  "error": "string",
  "execution": {
    "created_at": "string",
    "error": "string",
    "error_code": "string",
    "execution_id": "string",
    "message": "string",
    "org_id": "string",
    "project_id": "string",
    "session_id": "string",
    "startup_failure": {
      "boot_id": "string",
      "code": "string",
      "component": "string",
      "phase": "string",
      "source": "string"
    },
    "status": "string",
    "suspend_context": {},
    "suspend_reason": "string",
    "updated_at": "string",
    "user_id": "string"
  },
  "success": true
}

Response examples (400)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (400)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (401)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (401)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (404)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (404)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (500)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (500)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (502)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (502)

{
  "code": "string",
  "error": "string",
  "success": true
}