Skip to main content
Create a new isolated code execution context for managing variables and state.

​
Basic Request

curl -X POST https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/code/contexts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "data_analysis",
    "language": "python"
  }'

​
Request Parameters

ParameterTypeRequiredDescription
namestringYesContext name for identification
languagestringYesProgramming language (“python” or “javascript”)

​
Response

{
  "context_id": "ctx_550e8400-e29b-41d4-a716-446655440000",
  "name": "data_analysis",
  "language": "python",
  "created_at": "2025-01-27T10:30:00Z"
}

​
Response Fields

FieldTypeDescription
context_idstringUnique context identifier
namestringContext name
languagestringProgramming language
created_atstringCreation timestamp (ISO 8601)

​
Example: JavaScript Context

curl -X POST https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/code/contexts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web_server",
    "language": "javascript"
  }'

​
Use Cases

  • Isolated environments: Separate contexts for different tasks
  • State management: Maintain variables across executions
  • Multi-language support: Python and JavaScript contexts
  • Parallel processing: Multiple contexts for concurrent tasks

​
Next Steps

Run Code

Execute code in the context

Get Context

View context details and variables

List Contexts

View all contexts (GET request)

Delete Context

Clean up unused contexts