Rensei docs
API ReferenceAgent Cards

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.

POST
/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
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Request Body

application/json
  1. body
action*string
projectId*string
Length1 <= length
workflowId?string
Length1 <= length
nodeId?string
Length1 <= length
input*

Response Body

Current publication preview or committed immutable project Agent Card version.

Example Request
curl -X POST 'https://app.rensei.ai/api/agent-cards/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{  "action": "preview-effective",  "projectId": "string",  "input": {    "agentRef": null,    "property1": null,    "property2": null  }}'
Example Response
Empty

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.

Fork an installed reference agent card into a new owned identity.

Creates a new project-owned fork from an installed reference pin. The fork has a new content item and version identity and never receives source updates.