Skip to content

List the authenticated owner’s manager instances

POST
/manager-instances
curl --request POST \
--url https://auth.example.invalid/manager-instances \
--header 'Content-Type: application/json' \
--data '{ "idpToken": "example" }'

Fresh JSON idpToken derives the owner. POST is read-only. A complete scan returns complete=true, including an empty instances array. Scan failure is 503. Missing proof is 400; invalid proof is 401 or throttled 429. Origin is refused.

UTF-8 JSON; maximum 65536 bytes. An Authorization header does not replace the JSON proof.

Media typeapplication/json
object
idpToken
required
string
>= 1 characters

Examplegenerated

{
"idpToken": "example"
}

Successful response.

Media typeapplication/json
object
v
required
Allowed value: 1
owner
required
string
>= 1 characters
complete
required
instances
required
Array<object>
object
instanceId
required
string
>= 1 characters
placement
required
string
Allowed values: remote local
state
required
string
Allowed values: candidate unknown not open not this owner's not registered

Example

{
"v": 1,
"complete": true,
"instances": [
{
"placement": "remote",
"state": "candidate"
}
]
}

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

Media typeapplication/json
object
error
required
string
code
string
outcome
string
Allowed values: not-executed executed unknown

Example

{
"outcome": "not-executed"
}

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

Media typeapplication/json
object
error
required
string
code
string
outcome
string
Allowed values: not-executed executed unknown

Example

{
"outcome": "not-executed"
}

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

Media typeapplication/json
object
error
required
string
code
string
outcome
string
Allowed values: not-executed executed unknown

Example

{
"outcome": "not-executed"
}

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

Media typeapplication/json
object
error
required
string
code
string
outcome
string
Allowed values: not-executed executed unknown

Example

{
"outcome": "not-executed"
}

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

Media typeapplication/json
object
error
required
string
code
string
outcome
string
Allowed values: not-executed executed unknown

Example

{
"outcome": "not-executed"
}

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

Media typeapplication/json
object
error
required
string
code
string
outcome
string
Allowed values: not-executed executed unknown

Example

{
"outcome": "not-executed"
}

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

Media typeapplication/json
object
error
required
string
code
string
outcome
string
Allowed values: not-executed executed unknown

Example

{
"outcome": "not-executed"
}

Public admission cap (64 in flight), 10 second request deadline, or a route-specific unavailable read/effect. A service authority 503 may follow a binding; retain the request identity.

Media typeapplication/json
object
error
required
string
code
string
outcome
string
Allowed values: not-executed executed unknown

Example

{
"outcome": "not-executed"
}