`GET /api/resources` — one response type, unconditionally.

GET

/api/resources

This endpoint used to answer in oneOf<ResourceListResponse, ResourceMetaListResponse>,
selected by ?meta_only=true: two envelopes over two row types, so a generated client had a
union to discriminate and an agent had two shapes to learn. ?sections= replaces it — the
caller varies which parts of ResourceView are filled, never which type comes back. The
ListResourcesResponse enum, its untagged serde impl and its hand-written IntoResponse are
gone with it; ResourceListResponse is a plain Json return like every other read here.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Header Params

Responses

🟢200OK

application/json

Paginated list of visible resources with facets and paging state

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/resources?kb_doc_type_id=undefined&context_ref=undefined&doc_type_name=undefined&owner=undefined&q=undefined&stage=undefined&status=undefined&goal=undefined&tags=undefined&cogmap_ids=undefined&sort=undefined&order=undefined&limit=undefined&offset=undefined&sections=undefined' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "facets": {
        "doc_type": {
            "property1": 0,
            "property2": 0
        },
        "stage": {
            "property1": 0,
            "property2": 0
        },
        "status": {
            "property1": 0,
            "property2": 0
        }
    },
    "limit": 0,
    "offset": 0,
    "returned": 0,
    "rows": [
        {
            "body_hash": "string",
            "body_storage": null,
            "cogmap_id": "b2008c45-9f31-4aae-8f49-0cadcb6ad25e",
            "cogmap_name": "string",
            "content": "string",
            "context_name": "string",
            "context_owner_ref": "string",
            "context_ref": "string",
            "context_slug": "string",
            "created": "2019-08-24T14:15:22.123Z",
            "doc_type_name": "string",
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "ingest_state": null,
            "is_active": true,
            "kb_context_id": null,
            "managed_meta": {
                "temper-branch": "string",
                "temper-effort": "string",
                "temper-llm-model": "string",
                "temper-llm-run": "string",
                "temper-mode": "string",
                "temper-pr": "string",
                "temper-provenance": "string",
                "temper-seq": 0,
                "temper-stage": "string",
                "temper-status": "string"
            },
            "open_meta": null,
            "origin_uri": "string",
            "originator_profile_id": "20c67e1c-fb7d-4020-a7af-db154cdd188d",
            "owner_handle": "string",
            "owner_profile_id": "21e0f360-ea66-4de2-b817-b59c51592556",
            "ref": "string",
            "title": "string",
            "updated": "2019-08-24T14:15:22.123Z"
        }
    ],
    "total": 0,
    "truncated": true
}

Modified at 2026-08-19 12:26:18

reweight

create_resource

`GET /api/resources` — **one response type, unconditionally.**

Request

Responses

`GET /api/resources` — one response type, unconditionally.