> ## Documentation Index > Fetch the complete documentation index at: https://docs.bonya.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get a job run > Full run detail, including the stored spec that started it and an activity timeline. ## OpenAPI ````yaml /api-reference/openapi.yaml get /v1/job/{run_id} openapi: 3.1.0 info: title: Bonya Compute REST API version: 0.1.0 description: > Public REST and WebSocket surface on TApi behind Caddy. Non-2xx responses are RFC 9457 application/problem+json with a stable machine-readable code. WebSocket endpoints are HTTP GET upgrades; their options travel in the START frame, never in query strings. servers: - url: https://api.bonya.ai description: Production security: - personalApiKey: [] - supabaseJwt: [] tags: - name: Sandboxes description: Create, look up, list, pause, fork, snapshot, and delete sandboxes. - name: Snapshots description: Named point-in-time copies of a sandbox that new sandboxes can start from. - name: Templates description: Saved, versioned launch configurations for sandboxes. - name: Registry Connections description: Credentials for pulling private container images. - name: Secrets description: Write-only secrets and secret sets injected into sandboxes and jobs. - name: Previews description: Expose a sandbox port as an HTTPS URL. - name: Exec description: Run a command in a sandbox, buffered or over a TTY. - name: Sessions description: Named, persistent command sessions that outlive a connection. - name: Filesystem description: Read, write, and manage files inside a sandbox. - name: Jobs description: Managed, tracked runs of a command or script. - name: Job Schedules description: Cron, interval, or one-shot timing wrapped around a job. - name: Organizations description: Organization membership, administration and usage reporting. - name: Invitations description: Invite members to an organization and accept invitations. - name: API Keys description: Personal API key management. - name: Device Login description: Browser-based login for the CLI. paths: /v1/job/{run_id}: parameters: - $ref: '#/components/parameters/RunID' - $ref: '#/components/parameters/OrganizationHeader' get: tags: - Jobs summary: Get a job run description: >- Full run detail, including the stored spec that started it and an activity timeline. operationId: getJobRun responses: '200': description: Run detail content: application/json: schema: type: object required: - run properties: run: $ref: '#/components/schemas/JobRunDetail' default: $ref: '#/components/responses/Problem' components: parameters: RunID: name: run_id in: path required: true schema: type: string OrganizationHeader: name: X-Bonya-Organization-ID in: header required: false schema: type: string description: > Org context. Omitted means the caller's personal organization. A well-formed non-member org is 404; malformed is 400. schemas: JobRunDetail: allOf: - $ref: '#/components/schemas/JobRun' - type: object properties: job: $ref: '#/components/schemas/JobRequest' timeline: type: array items: $ref: '#/components/schemas/JobRunTimelineEntry' JobRun: type: object required: - run_id - status - created_sandbox - cleanup_failed - available_actions properties: run_id: type: string name: type: string description: Optional human-readable name for this job. status: type: string enum: - running - completed - failed - canceled - timed_out - terminated sandbox_id: type: string created_sandbox: type: boolean description: >- Distinguishes whether this run created sandbox_id or was given it, which decides whether the caller still owns it after the run. schedule_id: type: string started_at_unix_nanos: type: integer finished_at_unix_nanos: type: integer result: $ref: '#/components/schemas/JobResult' failure: type: string cleanup_failed: type: boolean description: >- The run finished but could not delete the sandbox it created. That sandbox is still billed and still visible in ListSandboxes. available_actions: type: array description: >- What the caller may do to this run right now, computed server-side. A client must not re-derive these from status alone. items: type: string enum: - cancel - rerun - retry - delete - delete_sandbox JobRequest: type: object description: >- Exactly one of existing_sandbox_id and new_sandbox is required. Exactly one of command and script is required. properties: name: type: string description: Optional human-readable name for this job. existing_sandbox_id: type: string new_sandbox: $ref: '#/components/schemas/JobNewSandboxSpec' command: type: array items: type: string script: $ref: '#/components/schemas/JobScriptSpec' pre_run_script: allOf: - $ref: '#/components/schemas/JobScriptSpec' description: >- Optional script executed after the sandbox is ready and before the job command or script. A non-zero exit stops the job. env: type: object additionalProperties: type: string secret_sets: type: array items: type: string description: Secret set names (see /v1/secret-sets). working_dir: type: string stdin_b64: type: string contentEncoding: base64 command_timeout_seconds: type: integer minimum: 1 run_deadline_seconds: type: integer minimum: 1 disposition: type: string enum: - delete - keep default: delete description: >- What happens to a sandbox this run created when the run ends, however it ends. Not meaningful for an existing sandbox. wake_if_paused: type: boolean default: false description: >- Applies to an existing sandbox only. False makes a paused target a failure rather than an implicit wake, which is a billable action the caller may not have intended. wait: type: boolean default: false description: >- false starts durably and returns immediately (202); true blocks for the result, bounded by the caller's own request timeout (200). JobRunTimelineEntry: type: object required: - name description: >- One activity attempt, decoded from the workflow engine's own event history. Nothing here is stored by this module; it stops existing once the namespace's retention window passes. properties: name: type: string attempt: type: integer started_at_unix_nanos: type: integer finished_at_unix_nanos: type: integer failure: type: string Problem: type: object required: - type - title - status - code properties: type: type: string title: type: string status: type: integer code: type: string detail: type: string JobResult: type: object required: - exit_code - signaled - timed_out - stdout_b64 - stderr_b64 - stdout_truncated - stderr_truncated description: >- The command's outcome. A non-zero exit_code is a completed run, not a failed one; a failure to create or resume the sandbox is a failed run instead, reported via the run's own failure field. properties: exit_code: type: integer signaled: type: boolean signal: type: integer timed_out: type: boolean stdout_b64: type: string contentEncoding: base64 stderr_b64: type: string contentEncoding: base64 stdout_truncated: type: boolean stderr_truncated: type: boolean JobNewSandboxSpec: type: object properties: template_id: type: string description: Omit to use the deployment's configured default template. template_revision: type: integer snapshot: type: string image: type: string name: type: string network: $ref: '#/components/schemas/NetworkPolicy' env: type: object additionalProperties: type: string secret_sets: type: array items: type: string JobScriptSpec: type: object required: - body description: >- A script the user wrote or uploaded. The body travels inline and is capped; a script larger than the cap is a program, and a program belongs in the template or fetched by the script itself. properties: body: type: string description: The script source text. interpreter: type: string default: sh args: type: array items: type: string filename: type: string NetworkPolicy: type: object additionalProperties: false required: - mode properties: mode: type: string enum: - open - allowlist - airgap default: open description: >- open is unrestricted egress; allowlist allows only the listed destinations; airgap has no network. allow: type: array maxItems: 64 items: $ref: '#/components/schemas/NetworkRule' allOf: - if: properties: mode: const: allowlist then: required: - allow properties: allow: minItems: 1 else: properties: allow: maxItems: 0 NetworkRule: type: object additionalProperties: false description: Exactly one of domain or cidr. Per-rule ports are not supported yet. properties: domain: type: string description: A DNS name such as pypi.org or *.pythonhosted.org. cidr: type: string responses: Problem: description: RFC 9457 problem content: application/problem+json: schema: $ref: '#/components/schemas/Problem' securitySchemes: personalApiKey: type: http scheme: bearer description: >- Personal byk_ API key; user-principal, resolved to a tenant by org context. supabaseJwt: type: http scheme: bearer bearerFormat: JWT description: >- Supabase-issued session JWT; required for org, invite, and key management. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.