Documentation Index Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
Use this file to discover all available pages before exploring further.
Las incidencias (issues) permiten comunicar problemas con respuestas o contenido. Usa estos endpoints para listar, crear, actualizar y cerrar incidencias.
Solicitud básica y respuesta
Lista incidencias con GET /api/v1/app/issue antes de crear o actualizar.
curl "https://{BASE_URL}/api/v1/app/issue?page=1&page_size=20" \
-H "Authorization: Bearer {API_TOKEN}"
-H "x-org: {org_slug}"
{
"data" : [
{
"id" : "issue_5c4b3a2d1e0f9a8b" ,
"issue_number" : 1842 ,
"description" : "Response missed the attached policy details." ,
"resource_type" : "Thread" ,
"type" : "NoContextUsed" ,
"state" : "NotReviewed" ,
"is_read" : false ,
"created_at" : "2026-02-08T14:55:10Z" ,
"updated_at" : "2026-02-08T14:55:10Z" ,
"created_by" : {
"id" : "user_4b7c2a1d9e5f3c8b" ,
"org_id" : "org_2f3a9d1c7b5e4a8f" ,
"account_id" : "acct_6c8a1f3b2d4e5f7a" ,
"name" : "Sasha Patel" ,
"email" : "sasha@auroralabs.com" ,
"state" : "Active" ,
"roles" : [ "AppAdmin" ],
"created_at" : "2026-02-08T14:12:45Z"
}
}
],
"has_next_page" : false ,
"has_previous_page" : false ,
"total_count" : 1
}
Crear una incidencia
curl -X POST "https://{BASE_URL}/api/v1/app/issue" \
-H "Authorization: Bearer {API_TOKEN}" \
-H "x-org: {org_slug}" \
-H "Content-Type: application/json" \
-d '{
"description": "Response missed the attached policy details.",
"resource_type": "Thread",
"type": "NoContextUsed",
"anonymous": false
}'
{
"id" : "issue_5c4b3a2d1e0f9a8b" ,
"issue_number" : 1842 ,
"description" : "Response missed the attached policy details." ,
"resource_type" : "Thread" ,
"type" : "NoContextUsed" ,
"state" : "NotReviewed" ,
"is_read" : false ,
"created_at" : "2026-02-08T14:55:10Z" ,
"updated_at" : "2026-02-08T14:55:10Z" ,
"created_by" : {
"id" : "user_4b7c2a1d9e5f3c8b" ,
"org_id" : "org_2f3a9d1c7b5e4a8f" ,
"account_id" : "acct_6c8a1f3b2d4e5f7a" ,
"name" : "Sasha Patel" ,
"email" : "sasha@auroralabs.com" ,
"state" : "Active" ,
"roles" : [ "AppAdmin" ],
"created_at" : "2026-02-08T14:12:45Z"
}
}
Obtener o actualizar una incidencia
Obtener incidencia
Actualizar incidencia
curl "https://{BASE_URL}/api/v1/app/issue/issue_5c4b3a2d1e0f9a8b" \
-H "Authorization: Bearer {API_TOKEN}"
-H "x-org: {org_slug}"
{
"id" : "issue_5c4b3a2d1e0f9a8b" ,
"issue_number" : 1842 ,
"description" : "Response missed the attached policy details." ,
"state" : "NotReviewed"
}
curl -X PUT "https://{BASE_URL}/api/v1/app/issue/issue_5c4b3a2d1e0f9a8b" \
-H "Authorization: Bearer {API_TOKEN}" \
-H "x-org: {org_slug}" \
-H "Content-Type: application/json" \
-d '{
"state": "InReview",
"is_read": true
}'
{
"id" : "issue_5c4b3a2d1e0f9a8b" ,
"state" : "InReview" ,
"is_read" : true
}
Eliminar una incidencia
curl -X DELETE "https://{BASE_URL}/api/v1/app/issue/issue_5c4b3a2d1e0f9a8b" \
-H "Authorization: Bearer {API_TOKEN}"
-H "x-org: {org_slug}"
Errores y casos límite
404 : incidencia no encontrada.
400 : estado inválido.