Resolve Presence | Athena | API Reference Docs

curl -X POST https://api.athenaintel.com/api/v0/workspaces/workspace_id/presence/resolve \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "asset_ids": [
    "asset_1f9b6b2e-4c1d-4a0a-9c1e-2b7d1a0f3c44"
  ],
  "include_members": true,
  "include_projects": true,
  "project_ids": [
    "asset_7c2d1e0f-3a4b-4c5d-8e6f-1a2b3c4d5e6f"
  ],
  "session_ids": [
    "thread_3f0a9c2e-6b1d-4d8e-8a2f-5c7e9b1d2a30"
  ]
}'

{
  "assets": [
    {
      "id": "asset_1f9b6b2e-4c1d-4a0a-9c1e-2b7d1a0f3c44",
      "asset_type": "document",
      "title": "Q3 close runbook"
    }
  ],
  "members": [
    {
      "email": "ada@example.com",
      "id": "user_5b8e2c1a-9d4f-4e3b-8c7a-6f1e2d3c4b5a",
      "name": "Ada Example"
    }
  ],
  "projects": [
    {
      "id": "asset_7c2d1e0f-3a4b-4c5d-8e6f-1a2b3c4d5e6f",
      "assets": [
        {
          "id": "asset_1f9b6b2e-4c1d-4a0a-9c1e-2b7d1a0f3c44",
          "asset_type": "document",
          "title": "Q3 close runbook"
        }
      ],
      "title": "Q3 close"
    }
  ],
  "sessions": [
    {
      "asset_id": "asset_0d4e8a7b-2c3f-4b1a-9e5d-6f7a8b9c0d1e",
      "thread_id": "thread_3f0a9c2e-6b1d-4d8e-8a2f-5c7e9b1d2a30",
      "title": "Reconcile the September ledger"
    }
  ]
}

Admin only. Resolve the guids a presence feed carries into display titles, asset kinds, and project membership, and optionally list the projects and members of the workspace. Every id is checked against the calling user’s own read permission as an ordinary member; anything the caller could not open is omitted rather than reported. Same gates as the presence-token mint.

Authentication

X-API-KEYstring

API Key authentication via header

Path parameters

workspace_idstringRequired1-128 characters

The workspace whose presence feed to read.

Request

This endpoint expects an object.

asset_idslist of stringsOptional

Asset guids from presence contexts of type asset.

include_membersbooleanOptionalDefaults to false

Also list the workspace’s members (name, email, avatar) so the app can name people by their attested user id rather than the self-reported slot.

include_projectsbooleanOptionalDefaults to false

Also list every project the caller may open in this workspace, each with the linked documents the caller may open.

project_idslist of stringsOptional

Project guids from coarse presence contexts or from a visible context's projects annotation.

session_idslist of stringsOptional

Thread ids from presence contexts of type session (what an open chat publishes). Each resolves to the workspace’s session asset.

Response

Successful Response

assetslist of objectsOptional

memberslist of objectsOptional

projectslist of objectsOptional

sessionslist of objectsOptional

Errors

422

Unprocessable Entity Error