GET /v1/personas takes page (from 1, default 1) and limit (1 to 100, default 20) and answers {"data": [...], "errors": null} with no total and no cursor; a page past the end is an empty list, and a page or limit outside its range is 400 validation_failed. GET /v1/personas/{persona_id} answers the persona itself, unwrapped. An id that does not start with per_ is 404 not_found, and so is an agent the credential cannot read.
The persona
A persona readsid (per_<agent id>), name, description, image_url, created_at, updated_at, deleted_at, current_draft_version_id, current_production_version_id, current_draft_version, current_production_version, inbound_numbers and workspace_id. name is the agent’s persona name, or its name when it has none. Both version ids are the same id, and both versions carry the same content: the draft copy differs only in version_type (draft).
A version reads id (perver_<agent id>_production), persona_id, version_type, version_number, created_at, updated_at, promoted_at, promoted_by, promoted_from_version_id, personality_prompt, orchestration_prompt, call_config, default_tools, entity_schemas, kb_ids, memory_enabled, pathway_conditions, skills and auth_config. call_config reads language, timezone, voice, record, wait_for_greeting, noise_cancellation, max_duration, transfer_phone_number, keywords, pronunciation_guide and background.
What follows the agent, read from its current specs, call settings and version history:
What is a fixed value, whatever the agent is configured with:
image_url, deleted_at and auth_config are null; promoted_at, promoted_by and promoted_from_version_id are null, because Sempera records when a version was built, not when it began reaching callers; orchestration_prompt is null, because an agent runs one conversation and has no routing prompt; transfer_phone_number is ""; and inbound_numbers, default_tools, entity_schemas, kb_ids, pathway_conditions and skills are empty lists. Read the agent’s tools and knowledge from its detail read (GET /v1/agents/{id}) and its numbers from GET /v1/phone-numbers?agent_id= (Sessions and calls).