Skip to main content
Get details of a specific code execution context, including current variables and state.

​
Basic Request

curl -X GET https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/code/contexts/{context_id} \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

ParameterTypeRequiredDescription
sandbox_idstringYesSandbox ID (UUID)
context_idstringYesContext ID (UUID)

​
Response

{
  "context_id": "ctx_550e8400-e29b-41d4-a716-446655440000",
  "name": "data_analysis",
  "language": "python",
  "created_at": "2025-01-27T10:30:00Z",
  "variables": {
    "df": "pandas.DataFrame",
    "total_rows": 1000,
    "processed": true
  }
}

​
Response Fields

FieldTypeDescription
context_idstringUnique context identifier
namestringContext name
languagestringProgramming language
created_atstringCreation timestamp (ISO 8601)
variablesobjectCurrent variables and their types/values

​
List All Contexts

Get all contexts in a sandbox: 
curl -X GET https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/code/contexts \
  -H "Authorization: Bearer YOUR_API_KEY"
Response: 
{
  "contexts": [
    {
      "context_id": "ctx_550e8400-e29b-41d4-a716-446655440000",
      "name": "data_analysis",
      "language": "python",
      "created_at": "2025-01-27T10:30:00Z"
    },
    {
      "context_id": "ctx_661e9511-f3ac-52e5-b827-557766551111",
      "name": "web_server",
      "language": "javascript",
      "created_at": "2025-01-27T10:35:00Z"
    }
  ]
}

​
Context Management

Use contexts to:
  • Isolate variables: Keep different tasks separate
  • Maintain state: Variables persist between executions
  • Debug code: Inspect current variable values
  • Organize work: Name contexts by purpose

​
Next Steps

Run Code

Execute code in the context

Create Context

Create new contexts

Delete Context

Clean up unused contexts

Get Sandbox Info

Monitor sandbox status