Skip to content

List an application's owners

GET
/api/v1/applications/{id}/owners
curl --request GET \
--url https://api.aletheia-ops.com/api/v1/applications/example/owners \
--header 'Authorization: Bearer <token>'
id
required
string

OK

Media typeapplication/json

Ownerships list response

object
ownerships
Array<object>

Public shape of a team/user ownership of an application or resource

object
id
string
organization_id
string
target_type
string
target_id
string
team_id
string
user_id
string
role
string
source
string
confidence
string
status
string
evidence
object
key
additional properties
any
last_confirmed_at
string format: date-time
created_by
string
created_at
string format: date-time
updated_at
string format: date-time
Examplegenerated
{
"ownerships": [
{
"id": "example",
"organization_id": "example",
"target_type": "example",
"target_id": "example",
"team_id": "example",
"user_id": "example",
"role": "example",
"source": "example",
"confidence": "example",
"status": "example",
"evidence": {},
"last_confirmed_at": "2026-04-15T12:00:00Z",
"created_by": "example",
"created_at": "2026-04-15T12:00:00Z",
"updated_at": "2026-04-15T12:00:00Z"
}
]
}

No valid credential was presented, or it has expired.

Media typeapplication/json
object
code
required

Stable, machine-readable identifier. Branch on this.

string
message
required

Human-readable explanation. Safe to display; do not parse.

string
Examples
{
"code": "unauthorized",
"message": "authentication required"
}

Authenticated, but not permitted to perform this action.

Media typeapplication/json
object
code
required

Stable, machine-readable identifier. Branch on this.

string
message
required

Human-readable explanation. Safe to display; do not parse.

string
Examples
{
"code": "forbidden",
"message": "you do not have permission to perform this action"
}

The resource does not exist, or belongs to another organization. The two are deliberately indistinguishable.

Media typeapplication/json
object
code
required

Stable, machine-readable identifier. Branch on this.

string
message
required

Human-readable explanation. Safe to display; do not parse.

string
Examples
Examplenot_found
{
"code": "not_found",
"message": "resource not found"
}

An unexpected failure. Diagnostic detail is logged server-side and deliberately not returned. Quote the X-Request-Id response header when reporting one.

Media typeapplication/json
object
code
required

Stable, machine-readable identifier. Branch on this.

string
message
required

Human-readable explanation. Safe to display; do not parse.

string
Examples
Exampleinternal_error
{
"code": "internal_error",
"message": "internal server error"
}