Rensei docs
API ReferenceAgent Cards

Get one agent card, including editor-prefill content.

Returns a single agent card with the rich list fields plus an editor-prefill `content` object (systemPrompt, responsibilities, outputContract, nonGoals, partials, tools). Returns 404 - never 403 - for a card in a different org or one the caller has no access to.

GET
/api/agent-cards/{id}

Authorization

headerAuthorizationBearer <rsk_live_*>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

Path Parameters

id*string

The agent card id.

Response Body

The agent card detail.

application/json
  1. response
card*

The full legacy agent-card detail; list fields plus editor content.

Example Request
curl -X GET 'https://app.rensei.ai/api/agent-cards/string'
Example Response
{  "card": {    "id": "string",    "name": "string",    "scope": "string",    "content": {      "property1": null,      "property2": null    },    "property1": null,    "property2": null  }}

List agent cards visible to the caller (system + org + optional project).

Returns agent cards resolved by scope (system + the caller org + an optional project scope). `format=full` returns rich `cards`; the default `format=autocomplete` returns lightweight `options`. Bearer-reachable for human principals (user token or browser session) - rsk_* API keys and BYOA OAuth-agent tokens are rejected 403; never surfaces another org's cards. This is also the read backing the tenant Marketplace screen (format=full, scope=all).

Preview an effective Agent Card or review/apply project publication.

The `preview-effective` action returns a safe, current card/prompt/configuration projection without credential values, admission, or dispatch. `preview-publication` returns the exact project identity, next immutable version, diagnostics, and confirmation token. `publish` requires a human project administrator and that exact reviewed token.