Skip to content
Moondeck docs

Get a persona suggestion

GET
/tasks/{id}/persona-suggestions/{suggestionId}

Requires: tasks.read

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Resource ULID.

suggestionId
required
string

The suggestion’s id (from the card’s message meta).

Header Parameters

Section titled “Header Parameters ”
x-uai-org
string

Org scope: me or an org slug. Absent means the caller’s active/personal org. It selects the workspace used for permission checks and for most resource filters; operation-specific access rules still apply.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful response.

object
suggestion
required
object
id
required
string
taskId
required
string
astronautId
required

The Astronaut’s handle on the task.

string
templateSlug
required
string | null
draft
required
object
name
required
string
>= 1 characters <= 64 characters
handle
string
"" <= 64 characters
role
string
"" <= 64 characters
summary
string
"" <= 500 characters
brief
string
"" <= 20000 characters
kind
required
string
>= 1 characters <= 64 characters
model
Any of:
string
>= 1 characters <= 64 characters
effort
Any of:
string
>= 1 characters <= 32 characters
skills
Array
default: <= 10 items
Any of:
object
store
required
string
>= 1 characters <= 128 characters
name
required
string
type
required
string
Allowed values: link document package
why
required

The Astronaut’s stated reason.

string
status
required
string
Allowed values: pending created dismissed
personaId
required

The persona it became.

string | null
personaName
required

That persona’s name as saved, which may differ from the draft’s.

string | null
resolvedBy
required
Any of:
object
userId
required
string
name
required
string
createdAt
required

Epoch milliseconds

integer
resolvedAt
required
Any of:
integer

401

Section titled “401 ”

UNAUTHORIZED — missing or invalid token, or an org-scoped API key (only user-scoped keys are accepted).

object
error
required
object
code
required

Stable, machine-readable error code

string
message
required

Human-readable explanation

string
details
permission

Present on 403 — the permission the caller lacked

string
feature

Present on 402 — gated feature

string
limit

Present on 402 — the plan’s cap

number
plan

Present on 402 — the current plan

string
seats

Present on 402 when the cap is seat-derived

object
seats
required

Effective seats the cap was computed from

integer
seatsMax
required
Any of:
integer
perSeat
required

Units of the resource each seat carries

number
key
additional properties
any

402

Section titled “402 ”

PLAN_LIMIT — the workspace’s plan does not include API access. Every API-key call can return this; session-token calls never do.

object
error
required
object
code
required

Stable, machine-readable error code

string
message
required

Human-readable explanation

string
details
permission

Present on 403 — the permission the caller lacked

string
feature

Present on 402 — gated feature

string
limit

Present on 402 — the plan’s cap

number
plan

Present on 402 — the current plan

string
seats

Present on 402 when the cap is seat-derived

object
seats
required

Effective seats the cap was computed from

integer
seatsMax
required
Any of:
integer
perSeat
required

Units of the resource each seat carries

number
key
additional properties
any

403

Section titled “403 ”

FORBIDDEN (lacking the required permission) or SCOPE_REQUIRED (no workspace, or a membership change in progress).

object
error
required
object
code
required

Stable, machine-readable error code

string
message
required

Human-readable explanation

string
details
permission

Present on 403 — the permission the caller lacked

string
feature

Present on 402 — gated feature

string
limit

Present on 402 — the plan’s cap

number
plan

Present on 402 — the current plan

string
seats

Present on 402 when the cap is seat-derived

object
seats
required

Effective seats the cap was computed from

integer
seatsMax
required
Any of:
integer
perSeat
required

Units of the resource each seat carries

number
key
additional properties
any

404

Section titled “404 ”

SCOPE_REQUIRED — the x-uai-org scope names a workspace that does not exist, or one the caller is not a member of. The two are deliberately indistinguishable: a 403 would confirm the workspace exists.

object
error
required
object
code
required

Stable, machine-readable error code

string
message
required

Human-readable explanation

string
details
permission

Present on 403 — the permission the caller lacked

string
feature

Present on 402 — gated feature

string
limit

Present on 402 — the plan’s cap

number
plan

Present on 402 — the current plan

string
seats

Present on 402 when the cap is seat-derived

object
seats
required

Effective seats the cap was computed from

integer
seatsMax
required
Any of:
integer
perSeat
required

Units of the resource each seat carries

number
key
additional properties
any

503

Section titled “503 ”

SCOPE_REQUIRED — membership reconciliation required, or membership verification unavailable.

object
error
required
object
code
required

Stable, machine-readable error code

string
message
required

Human-readable explanation

string
details
permission

Present on 403 — the permission the caller lacked

string
feature

Present on 402 — gated feature

string
limit

Present on 402 — the plan’s cap

number
plan

Present on 402 — the current plan

string
seats

Present on 402 when the cap is seat-derived

object
seats
required

Effective seats the cap was computed from

integer
seatsMax
required
Any of:
integer
perSeat
required

Units of the resource each seat carries

number
key
additional properties
any