Labs

Get agent lab documents

GET /v1/labs/agent/documents · getAgentLabDocuments

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl 'https://api.openagents.com/v1/labs/agent/documents' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• AgentLabClient::documents

Post agent lab documents

POST /v1/labs/agent/documents · postAgentLabDocuments

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Request body

Content type: application/json

Type: object

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/agent/documents' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

Get agent lab documents id

GET /v1/labs/agent/documents/{id} · getAgentLabDocumentsId

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl 'https://api.openagents.com/v1/labs/agent/documents/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• AgentLabClient::document

Put agent lab documents id

PUT /v1/labs/agent/documents/{id} · putAgentLabDocumentsId

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: object

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl -X PUT 'https://api.openagents.com/v1/labs/agent/documents/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

Delete agent lab documents id

DELETE /v1/labs/agent/documents/{id} · deleteAgentLabDocumentsId

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: object

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl -X DELETE 'https://api.openagents.com/v1/labs/agent/documents/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

In the Rust SDK

• AgentLabClient::delete_document

Post agent lab documents id jobs

POST /v1/labs/agent/documents/{id}/jobs · postAgentLabDocumentsIdJobs

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: object

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/agent/documents/{id}/jobs' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

In the Rust SDK

• AgentLabClient::start

Post agent lab documents id promote

POST /v1/labs/agent/documents/{id}/promote · postAgentLabDocumentsIdPromote

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: object

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/agent/documents/{id}/promote' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

In the Rust SDK

• AgentLabClient::promote

Get agent lab hosts

GET /v1/labs/agent/hosts · getAgentLabHosts

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl 'https://api.openagents.com/v1/labs/agent/hosts' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• AgentLabClient::hosts

Post agent lab hosts

POST /v1/labs/agent/hosts · postAgentLabHosts

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Request body

Content type: application/json

Type: object

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/agent/hosts' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

In the Rust SDK

• AgentLabClient::heartbeat

Get agent lab jobs

GET /v1/labs/agent/jobs · getAgentLabJobs

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl 'https://api.openagents.com/v1/labs/agent/jobs' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• AgentLabClient::runs

Get agent lab jobs id

GET /v1/labs/agent/jobs/{id} · getAgentLabJobsId

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl 'https://api.openagents.com/v1/labs/agent/jobs/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• AgentLabClient::run

Post agent lab jobs id actions

POST /v1/labs/agent/jobs/{id}/actions · postAgentLabJobsIdActions

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: object

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/agent/jobs/{id}/actions' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

In the Rust SDK

• AgentLabClient::change

Post agent lab jobs id host

POST /v1/labs/agent/jobs/{id}/host · postAgentLabJobsIdHost

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: object

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/agent/jobs/{id}/host' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

In the Rust SDK

• AgentLabClient::host_update

Get agent lab kinds

GET /v1/labs/agent/kinds · getAgentLabKinds

Account-private Agent Lab documents, finite test plans and reports. See docs/agent-lab/README.md and the Rust SDK labs module for typed bodies. No execution on reads, document save, card rendering or promotion. A supporting host prepares isolated inputs before using the normal agent assignment service. Mutations retain request_id receipts; changed retries conflict. Updates require expected_revision. Maximum request 192 KiB; per-account storage 16 MiB, 64 documents, 64 versions each, 128 runs, 8 active jobs and 8192 receipts. Trials are bounded to 32 and 30 minutes. Cost may be unknown. What a host reports is the account's claim, not proof we checked.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Response

200 — Account-owned result; Cache-Control: no-store, private.

Errors

Example

curl 'https://api.openagents.com/v1/labs/agent/kinds' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

Get lab artifact

GET /v1/labs/artifacts/{id} · getLabArtifact

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabArtifactLink

Errors

Example

curl 'https://api.openagents.com/v1/labs/artifacts/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

Read lab artifact

GET /v1/labs/artifacts/{id}/content · readLabArtifact

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Content type: application/octet-stream

Type: LabBytes (string (binary))

206 — Private, no-store result.

Content type: application/octet-stream

Type: LabBytes (string (binary))

Errors

Example

curl 'https://api.openagents.com/v1/labs/artifacts/{id}/content' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

List lab documents

GET /v1/labs/documents · listLabDocuments

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabDocuments

Errors

Example

curl 'https://api.openagents.com/v1/labs/documents' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::documents

Create lab document

POST /v1/labs/documents · createLabDocument

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Request body

Content type: application/json

Type: LabCreateDocument

Response

201 — Private, no-store result.

Type: LabVersion

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/documents' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "string",
  "kind": "string",
  "schema": "string",
  "title": "string",
  "content": {},
  "summary": "string"
}'

In the Rust SDK

• Client::create_document

Get lab document

GET /v1/labs/documents/{id} · getLabDocument

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabDocumentMeta

Errors

Example

curl 'https://api.openagents.com/v1/labs/documents/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::document

Delete lab document

DELETE /v1/labs/documents/{id} · deleteLabDocument

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabDeleted

Errors

Example

curl -X DELETE 'https://api.openagents.com/v1/labs/documents/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::delete_document

Read lab events

GET /v1/labs/documents/{id}/events · readLabEvents

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabEvents

Errors

Example

curl 'https://api.openagents.com/v1/labs/documents/{id}/events' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::events_since
• Events::next

List lab notes

GET /v1/labs/documents/{id}/notes · listLabNotes

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabNotes

Errors

Example

curl 'https://api.openagents.com/v1/labs/documents/{id}/notes' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::notes

Add lab note

POST /v1/labs/documents/{id}/notes · addLabNote

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: LabAddNote

Response

201 — Private, no-store result.

Type: LabSaved

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/documents/{id}/notes' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "version": 0,
  "locator": {
    "at": "none"
  },
  "text": "string"
}'

In the Rust SDK

• Client::add_note

List lab versions

GET /v1/labs/documents/{id}/versions · listLabVersions

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabVersions

Errors

Example

curl 'https://api.openagents.com/v1/labs/documents/{id}/versions' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::versions

Create lab version

POST /v1/labs/documents/{id}/versions · createLabVersion

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: LabEditDocument

Response

201 — Private, no-store result.

Type: LabVersion

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/documents/{id}/versions' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "base": 0,
  "change": {
    "ops": [
      {
        "path": "string",
        "value": {},
        "op": "add"
      }
    ],
    "type": "patch"
  },
  "summary": "string"
}'

In the Rust SDK

• Client::edit

Get lab version

GET /v1/labs/documents/{id}/versions/{n} · getLabVersion

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabVersion

Errors

Example

curl 'https://api.openagents.com/v1/labs/documents/{id}/versions/{n}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::version

Get lab card

GET /v1/labs/documents/{id}/versions/{n}/card · getLabCard

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabCard

Errors

Example

curl 'https://api.openagents.com/v1/labs/documents/{id}/versions/{n}/card' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::card

List lab jobs

GET /v1/labs/jobs · listLabJobs

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabJobs

Errors

Example

curl 'https://api.openagents.com/v1/labs/jobs?document=...' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::jobs

Create lab job

POST /v1/labs/jobs · createLabJob

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: LabCreateJob

Response

201 — Private, no-store result.

Type: LabJobState

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/jobs' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Idempotency-Key: ...' \
  -H 'Content-Type: application/json' \
  -d '{
  "version": {
    "document": "string",
    "version": 0
  },
  "want": {
    "want": "card"
  }
}'

In the Rust SDK

• Client::create_job

Get lab job

GET /v1/labs/jobs/{id} · getLabJob

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabJobState

Errors

Example

curl 'https://api.openagents.com/v1/labs/jobs/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

Cancel lab job

DELETE /v1/labs/jobs/{id} · cancelLabJob

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabJobState

Errors

Example

curl -X DELETE 'https://api.openagents.com/v1/labs/jobs/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

Get lab job usage

GET /v1/labs/jobs/{id}/usage · getLabJobUsage

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabWorkerUsage (array of object)

Errors

Example

curl 'https://api.openagents.com/v1/labs/jobs/{id}/usage' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

List lab kinds

GET /v1/labs/kinds · listLabKinds

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabKinds

Errors

Example

curl 'https://api.openagents.com/v1/labs/kinds' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::kinds

List lab tools

GET /v1/labs/kinds/{kind}/tools · listLabTools

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabTools

Errors

Example

curl 'https://api.openagents.com/v1/labs/kinds/{kind}/tools' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

In the Rust SDK

• Client::tools

Call lab tool

POST /v1/labs/kinds/{kind}/tools/{name} · callLabTool

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Request body

Content type: application/json

Type: LabToolCall

Response

200 — Private, no-store result.

Type: LabToolResult

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/kinds/{kind}/tools/{name}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "arguments": {}
}'

In the Rust SDK

• Client::invoke

Upload lab source

POST /v1/labs/uploads · uploadLabSource

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Request body

Content type: application/json

Type: LabUpload

Response

201 — Private, no-store result.

Type: LabArtifact

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/uploads' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "version": {
    "document": "string",
    "version": 0
  },
  "media_type": "string",
  "class": "public",
  "content_base64": "string"
}'

In the Rust SDK

• Client::upload

Enroll lab worker

POST /v1/labs/workers · enrollLabWorker

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Request body

Content type: application/json

Type: LabWorkerEnroll

Response

200 — Private, no-store result.

Type: LabWorkerEnrolled

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/workers' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "capabilities": {
    "worker": "string",
    "placement": "server",
    "cpu_millis": 0,
    "memory_bytes": 0,
    "gpu": false,
    "tools": [
      "string"
    ],
    "jobs": [
      "string"
    ],
    "local_assets": [
      "string"
    ],
    "max_seconds": 0
  }
}'

In the Rust SDK

• Client::enroll_worker

Finish lab worker job

POST /v1/labs/workers/finish · finishLabWorkerJob

Outbound job-worker operation. Checks current sign-in, account, project membership, kind access and lease before each operation. Requests cannot select another space or executable.

Sign-in: a bearer credential in the Authorization header.

labWorkerBearer: A revocable job-only labw_ key for one named space. Account sign-in keys are not accepted.

Request body

Content type: application/json

Type: LabWorkerFinish

Response

200 — Private, no-store result.

Type: LabJobState

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/workers/finish' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "job": "string",
  "attempt": 0,
  "status": "queued"
}'

Heartbeat lab worker job

POST /v1/labs/workers/heartbeat · heartbeatLabWorkerJob

Outbound job-worker operation. Checks current sign-in, account, project membership, kind access and lease before each operation. Requests cannot select another space or executable.

Sign-in: a bearer credential in the Authorization header.

labWorkerBearer: A revocable job-only labw_ key for one named space. Account sign-in keys are not accepted.

Request body

Content type: application/json

Type: LabWorkerAttempt

Response

200 — Private, no-store result.

Type: LabWorkerWork

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/workers/heartbeat' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "job": "string",
  "attempt": 0
}'

List lab worker inputs

POST /v1/labs/workers/inputs · listLabWorkerInputs

Outbound job-worker operation. Checks current sign-in, account, project membership, kind access and lease before each operation. Requests cannot select another space or executable.

Sign-in: a bearer credential in the Authorization header.

labWorkerBearer: A revocable job-only labw_ key for one named space. Account sign-in keys are not accepted.

Request body

Content type: application/json

Type: LabWorkerAttempt

Response

200 — Private, no-store result.

Type: LabWorkerInputs

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/workers/inputs' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "job": "string",
  "attempt": 0
}'

Read lab worker input

POST /v1/labs/workers/inputs/file · readLabWorkerInput

Outbound job-worker operation. Checks current sign-in, account, project membership, kind access and lease before each operation. Requests cannot select another space or executable.

Sign-in: a bearer credential in the Authorization header.

labWorkerBearer: A revocable job-only labw_ key for one named space. Account sign-in keys are not accepted.

Request body

Content type: application/json

Type: LabWorkerInputFile

Response

200 — Private, no-store result.

Content type: application/octet-stream

Type: LabBytes (string (binary))

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/workers/inputs/file' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "job": "string",
  "attempt": 0,
  "artifact": "string"
}'

Poll lab worker

POST /v1/labs/workers/poll · pollLabWorker

Outbound job-worker operation. Checks current sign-in, account, project membership, kind access and lease before each operation. Requests cannot select another space or executable.

Sign-in: a bearer credential in the Authorization header.

labWorkerBearer: A revocable job-only labw_ key for one named space. Account sign-in keys are not accepted.

Request body

Content type: application/json

Type: LabWorkerPoll

Response

200 — Private, no-store result.

Type: LabWorkerAvailable

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/workers/poll' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "wait_seconds": 0
}'

Start lab worker job

POST /v1/labs/workers/start · startLabWorkerJob

Outbound job-worker operation. Checks current sign-in, account, project membership, kind access and lease before each operation. Requests cannot select another space or executable.

Sign-in: a bearer credential in the Authorization header.

labWorkerBearer: A revocable job-only labw_ key for one named space. Account sign-in keys are not accepted.

Request body

Content type: application/json

Type: LabWorkerAttempt

Response

200 — Private, no-store result.

Type: LabWorkerWork

Errors

Example

curl -X POST 'https://api.openagents.com/v1/labs/workers/start' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "job": "string",
  "attempt": 0
}'

Revoke lab worker

DELETE /v1/labs/workers/{id} · revokeLabWorker

Authorizes the caller and space on every request. Experimental kinds use the Computers account gate. Reads never start jobs. Pages and payloads are bounded. Source uploads are capped at 512 KiB until resumable uploads are integrated.

Sign-in: a bearer credential in the Authorization header.

appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.

Parameters

Response

200 — Private, no-store result.

Type: LabWorkerRevoked

Errors

Example

curl -X DELETE 'https://api.openagents.com/v1/labs/workers/{id}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"