Recall cognitive state

curl --request GET \
  --url https://api.get-exo.com/v1/recall/{recall_type} \
  --header 'X-Exo-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Exo-API-Key': '<api-key>'}};

fetch('https://api.get-exo.com/v1/recall/{recall_type}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "type": "<string>",
  "basinHistory": [
    {}
  ],
  "contradictions": [
    {
      "id": "<string>",
      "kind": "<string>",
      "title": "<string>",
      "afterText": "<string>",
      "beforeText": "<string>",
      "createdAt": "<string>",
      "marker": "<string>"
    }
  ],
  "manifoldState": {
    "basin_centers": [
      [
        123
      ]
    ],
    "basins": [
      {}
    ],
    "cumulative_variance": 123,
    "dimensions": [
      {}
    ],
    "discovered_at": "<string>",
    "n_basins": 123,
    "n_dimensions": 123,
    "n_signals": 123,
    "refresh_count": 123,
    "silhouette_score": 123,
    "trajectory": [
      {}
    ],
    "variance_ratios": [
      123
    ],
    "version": 123
  },
  "recentPatterns": [
    {
      "patternType": "<string>",
      "confidence": 123,
      "description": "<string>",
      "observedBehavior": "<string>"
    }
  ],
  "voiceProfile": {
    "avgMessageLengthWords": 123,
    "evidenceCount": 123,
    "formalityLevel": 123,
    "technicalDepth": 123
  }
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

GET

recall

{recall_type}

Recall cognitive state

curl --request GET \
  --url https://api.get-exo.com/v1/recall/{recall_type} \
  --header 'X-Exo-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Exo-API-Key': '<api-key>'}};

fetch('https://api.get-exo.com/v1/recall/{recall_type}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "type": "<string>",
  "basinHistory": [
    {}
  ],
  "contradictions": [
    {
      "id": "<string>",
      "kind": "<string>",
      "title": "<string>",
      "afterText": "<string>",
      "beforeText": "<string>",
      "createdAt": "<string>",
      "marker": "<string>"
    }
  ],
  "manifoldState": {
    "basin_centers": [
      [
        123
      ]
    ],
    "basins": [
      {}
    ],
    "cumulative_variance": 123,
    "dimensions": [
      {}
    ],
    "discovered_at": "<string>",
    "n_basins": 123,
    "n_dimensions": 123,
    "n_signals": 123,
    "refresh_count": 123,
    "silhouette_score": 123,
    "trajectory": [
      {}
    ],
    "variance_ratios": [
      123
    ],
    "version": 123
  },
  "recentPatterns": [
    {
      "patternType": "<string>",
      "confidence": 123,
      "description": "<string>",
      "observedBehavior": "<string>"
    }
  ],
  "voiceProfile": {
    "avgMessageLengthWords": 123,
    "evidenceCount": 123,
    "formalityLevel": 123,
    "technicalDepth": 123
  }
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>",
  "documentationUrl": "<string>",
  "errors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>",
      "pointer": "<string>"
    }
  ],
  "requestId": "",
  "suggestedAction": "<string>"
}

recall_type is one of identity (manifold position, voice profile, recent patterns), graph (nodes, edges and domains), insights (pending graph proposals) or temporal (phases and time structure). Any other value returns 404. Every view is scoped to the caller’s org; there is no cross-org read. A freshly imported org returns empty collections until the background cognition cycle has run. The response is one of four documented shapes, told apart by the type field every one of them carries.

Authorization

This route requires the read scope. A missing or invalid credential returns 401 authentication_error. A valid credential without the scope returns 403 permission_denied, and the problem body names the exact scope required.

Headers

These are request conventions the contract does not declare as parameters, so they do not appear in the schema tables below.

Header	Applies	What it does
`X-Exo-API-Key`	Required	Your Exo API key, `exo_<env>_<token>`. `Authorization: Bearer exo_...` is accepted as an alternate.
`X-Exo-Subject`	Optional	Acts for a provisioned subject instead of the key owner. An unprovisioned id returns 403 `subject_not_provisioned`.
`Idempotency-Key`	Not applicable	The replay engine covers POST requests only.
`X-Request-Id`	Response	Returned on every response, including `204`s. Quote it in a support request.

Success responses

Status	Meaning
`200`	The requested cognitive-state view.

Errors

Status	Code	When
`400`	`invalid_request`	Malformed request, for example an invalid cursor.
`401`	`authentication_error`	Missing or invalid credentials.
`403`	`permission_denied`	Missing scope, or an unprovisioned subject selector.
`404`	`not_found`	The resource does not exist, or is not visible to this caller.
`409`	`conflict`	A conflict with the current state of the resource.
`422`	`validation_error`	The request was understood but failed field validation.
`429`	`rate_limit_exceeded`	Rate limit exceeded. Retry after the Retry-After interval.
`503`	`service_degraded`	A dependency is temporarily unavailable. Safe to retry.

Every error is an RFC 9457 application/problem+json body carrying a stable code, a requestId, and a suggestedAction where Exo has one. See Errors.

Notes

One route, four views. recall_type is identity, graph, insights or temporal, and each returns a different response shape. Any other value is 404.
Empty collections are the correct answer for a new organization. The views are built by the background cognition cycle, so a freshly imported organization reads empty until it has run.
Pagination is opt-in and not available on every view. Sending cursor or pageSize to a view that is not a list returns 400 pagination_unsupported.

Authorizations

X-Exo-API-Key

string

header

required

An Exo API key (exo_...) sent as the X-Exo-API-Key header.

Path Parameters

recall_type

string

required

Query Parameters

cursor

string | null

Opaque cursor from a previous nextCursor. Supported on the list-shaped views (insights, temporal).

pageSize

integer | null

Page size, coerced into [1, 100] (default 25). Supplying it (or a cursor) switches the list-shaped views to a paginated response.

Response

The requested cognitive-state view.

RecallIdentityResponse
RecallGraphResponse
RecallInsightsResponse
RecallTemporalResponse

The identity view of cognitive state: who Exo has learned the subject to be.

Every facet fills in independently as the background cognition cycle warms, so a freshly imported subject gets this envelope with null manifold state, no voice profile and empty lists rather than an error.

type

string

required

Names the view, always 'identity'.

Allowed value: "identity"

basinHistory

Basinhistory · object[]

Recorded snapshots of the subject's position on the identity surface, oldest first. Empty until snapshots have been taken.

contradictions

IdentityContradiction · object[]

Points where the subject changed their mind, most recent first.

Show child attributes

manifoldState

ManifoldState · object | null

The discovered surface of how the subject thinks. Null before the first discovery pass.

Show child attributes

recentPatterns

IdentityPattern · object[]

Observed behavioural patterns, strongest first.

Show child attributes

voiceProfile

VoiceProfile · object | null

How the subject writes. Null until there is evidence behind it.

Show child attributes

Recall

Get a graph node

⌘I

​Authorization

​Headers

​Success responses

​Errors

​Notes

Authorizations

Path Parameters

Query Parameters

Response

Authorization

Headers

Success responses

Errors

Notes