Listar rascunhos de prompt
Lista os rascunhos recortados pelo alcance, do mais novo ao mais antigo. agent_id, template_id e status estreitam. Filtrar por um agente fora do alcance responde 404.
Autorização
bearer agents:readCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: agents:read
Parâmetros de consulta
Estreita para os rascunhos de um agente.
uuidEstreita para os rascunhos de um template.
uuidEstreita pelo estado.
Valor em
- "pending"
- "running"
- "completed"
- "failed"
- "cancelled"
Cursor opaco devolvido em page.next_cursor da página anterior. Omita para começar do início.
Tamanho da página. Padrão 50; o máximo é o da coleção: 200, ou até 500 nas coleções de itens pequenos.
int320 <= valueCorpo da resposta
application/json
application/json
curl -X GET "https://example.com/prompt-drafts"{ "data": [ { "artifacts": [ { "artifact_type": "string", "content": "string", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "metadata": null, "name": "string", "version": 0 } ], "created_at": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "model_used": "string", "name": "string", "status": "pending", "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc", "template_version": 0, "text_agent_id": "af40f7e4-adef-491d-8f6d-bda3f0ebfb04", "updated_at": "string", "usage": null, "voice_agent_id": "2fc8d568-5ce2-4e51-baa8-38c877b5dd08" } ], "page": { "has_more": true, "next_cursor": "string" }}