Skip to content

Pull retained contexts and immutable publication snapshots, including exact configuration generations and the default-false reserved run payload namespace capability.

GET
/connector/v1/configuration

Pull retained contexts and immutable publication snapshots, including exact configuration generations and the default-false reserved run payload namespace capability.

Media typeapplication/json
object
contexts
required
Array<object>
object
definition
required
object
connection
required
One of: discriminator: kind
object
kind
required
string
Allowed values: direct
launcher
required

Absolute runner launcher argv. Managed execution requires a separate identity; development requires explicit host consent and the same non-root UID.

Array<string>
>= 1 items <= 32 items
driver
required
One of: discriminator: kind
object
kind
required
string
Allowed values: process
scratch
object
cache
required
string
Allowed values: none per_run
max_bytes
required
integer
>= 1 <= 18446744073709552000
max_depth
required
integer
>= 1 <= 64
max_entries
required
integer
>= 1 <= 1000000
scan_interval_ms
required
integer
>= 100 <= 60000
symlinks
required
string
Allowed values: forbid workspace_only
execution_mode

Development permits trusted same-user execution only with process/direct and explicit connector host opt-in. Model code can access that user’s connector credentials and files.

string
default: managed
Allowed values: managed development
installation_roots
required
Array<string>
>= 1 items <= 32 items
max_outstanding_assignments
required
integer
>= 1 <= 1024
shared_workspace
object
connector_root
required
string
runner_root
required
string
work_root
required
string
id
required
string
<= 64 characters /^[a-z][a-z0-9_-]{0,63}$/
generation
required
integer format: int64
>= 1
publications
required
Array<object>
<= 1024 items
object
context_id
required
string
<= 64 characters /^[a-z][a-z0-9_-]{0,63}$/
descriptor
required

Internal registration snapshot used by connector configuration and execution evidence.

object
entrypoint
required

First argument is an executable path relative to release_path.

Array<string>
environment
object
key
additional properties
string
installation
required

Identity claims derived from the retained scientific definition. They do not independently attest the provider’s installed software.

object
dataset_identities
required
Array<string>
model_identity
required
string
runtime_identity
required
string
wrapper_identity
required
string
wrapper_protocol_version
required
integer format: int32
provider_binding_id
required
string
release_path
required
string
slurm_script

Model-supplied batch file relative to release_path; required for Slurm.

string | null
generation
required
integer format: int64
>= 1
publication_id
required
string
<= 64 characters /^[a-z][a-z0-9_-]{0,63}$/
requirements
required

Requirements derived from an immutable context and scientific contract. These are execution needs, not observations of backend support.

object
capabilities
required
Array<string>
Allowed values: json_inputs json_outputs artifact_inputs artifact_outputs large_artifacts collection_inputs collection_outputs
driver
required

Execution mechanisms, independent of the wrapper’s request/result protocol.

string
Allowed values: process slurm
wrapper_protocol_version
required
integer format: int32
run_payload_namespace_reserved

True only when new registrations reject release directories and declared entrypoint/batch files inside any known context work_root/UUID subtree. Missing or false on an older service does not establish payload-cleanup protection.

boolean
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Malformed request.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Valid active credential required; connector and user credentials are separate.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

The token does not permit this operation.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Resource absent or outside the caller’s authority.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Concurrent generation/publication change, conflicting retry, or a publication awaiting connector validation.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

413: the request body exceeds the configured size limit.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Request fields, manifest, installation policy, or limits are invalid.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Authentication, identity provider, or management state is temporarily unavailable.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

An HTTP request failed; inspect the stable error code and request ID.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Documentation 205dcb3116ea · public sources 8c70356d340f · built .Download documentation identity.