Skip to main content
GET
Get an application's subject state

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

application_id
string
required

Query Parameters

environment
string

The environment in view, by name; its one deployment is the binding when the query names no cluster.

Maximum string length: 200
cluster_id
string<uuid>

The cluster of the place the page read; with namespace it picks the binding.

namespace
string

The namespace of the place the page read.

Maximum string length: 63
deploy_run_id
string<uuid>

The deploy run a hand-off pointed at; echoed on the subject.

conversation_id
string

The chat conversation whose actions on the subject to list; without it the actions section is unknown.

Maximum string length: 128

Response

The subject state, every section with its own presence

One platform read of everything Ankra records about an application in an environment. Every section is three-state: present, absent (a successful read that found nothing) or unknown (the read failed or was never attempted; never a negative).

subject
SubjectStateSubject · object
required

The thing the state is about, as the caller named it.

read_at
string
required
application
SubjectStateApplication · object
required

The application's own record.

binding
SubjectStateBinding · object
required

The place the subject resolves to: place is set when exactly one matches; places lists them when several do.

health
SubjectStateHealth · object
required

The bound deployment's current state.

deploy_runs
SubjectStateDeployRuns · object
required

The newest deploy runs of the bound place, newest first.

builds
SubjectStateBuilds · object
required

The newest platform builds, newest first.

pull_requests
SubjectStatePullRequests · object
required

The setup pull request the platform opened and the reviews Ankra AI wrote.

tickets
SubjectStateTickets · object
required

The AI board's tickets about the subject.

platform_errors
SubjectStatePlatformErrors · object
required

The active platform errors on the subject.

chat_actions
SubjectStateChatActions · object
required

The conversation's recent actions on the subject.