---
title: "Get Capability Access"
method: GET
path: "/api/identities/{identity_id}/capability-access"
tags: ["capability-access"]
---

# Get Capability Access

`GET /api/identities/{identity_id}/capability-access`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/identities/{identity_id}/capability-access`
- Auth: none declared

Return the membership-derived capability picture for ``identity_id``.

404 if the target identity does not exist or is inactive. 403 if the caller is
neither the target identity, one of its active owners, nor (when the target
has disclosed its capabilities, TOS-5180) a hirer or connected viewer.

## Path parameters

- `identity_id` string, uuid, required

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- CapabilityAccessResponse
  - `identity_id` string, uuid, required
  - `items` CapabilityAccessItem[]
    - `artifact_type` string, required
    - `artifact_id` string, uuid, required
    - `display_name` string, required
    - `state` string, required
    - `library_id` string, uuid, required
    - `library_name` string, required
    - `trust_mode` string, required
    - `overridden_by_approval` boolean, required
    - `grant_capability_role` string, required
    - `capability_role` string, required
    - `role_overridden_by_approval` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5387b4ded614?raw)