Returns stable identity and current permission-filtered run facts without definition instructions, binding identifiers, private input, or provider traces.
Path Parameters
workspace_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
definition_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
Header Parameters
X-Assign-Realtime-Baseline
string
Upcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
Values
1
Responses
X-Assign-Realtime-Cursor
string·max 4096
Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
X-Assign-Realtime-Position
string
Decimal-string snapshot position; present only with a successful baseline cursor.
definition_idRequired
string <uuid>
Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Example0198ac5e-f9b7-7000-8000-000000000001
actor_idRequired
string <uuid>
Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Example0198ac5e-f9b7-7000-8000-000000000001
nameRequired
string·min 1·max 80
descriptionRequired
string·min 1·max 500
responsibilityRequired
string·min 1·max 500
manager_actor_idRequired
string <uuid>
Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Example0198ac5e-f9b7-7000-8000-000000000001
personalityRequired
string·max 1000
conversation_startersRequired
string[]·max 6
knowledge_categoriesRequired
string[]·max 32
capabilitiesRequired
string[]·max 32
prohibited_actionsRequired
string[]·max 12
approval_boundaryRequired
string·min 1·max 200
trigger_typesRequired
string[]·min 1·max 3
Values
manualeventschedule
stateRequired
string
Values
draftactivepausedremoved
revisionRequired
integer <int64>·min 1
last_started_at
string <date-time>
RFC 3339 timestamp in UTC.
Example2026-08-15T12:00:00Z
last_finished_at
string <date-time>
RFC 3339 timestamp in UTC.
Example2026-08-15T12:00:00Z
last_successful_at
string <date-time>
RFC 3339 timestamp in UTC.
Example2026-08-15T12:00:00Z
latest_outcomeRequired
string·max 4000
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Retry-After
integer·min 0
Delay in seconds before retrying, when an expected maintenance end is known.
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
