Pular para o conteúdo
Ações

Listar as Ações desta chave

v1.0.0
GEThttps://api.growthaisystem.com/api/v1/actions
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposactions.read

As Ações do Núcleo que ESTA chave pediu (nunca as de outra chave). Use ?status=pending_approval para reconciliar o que ainda espera decisão. Uma Ação pendente cujo prazo passou aparece como expired.

Parâmetros de consulta

Vão na querystring, depois do ?.

  • statusstringopcional

    Filtra pelo status público (com expired calculado na leitura).

    • um de"pending_approval""approved""executing""done""rejected""expired""failed"
  • cursorstringopcional
  • limitintegeropcional
    • padrão 25
    • faixa 1–100

Respostas

6 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

As Ações pedidas por esta chave, da mais nova para a mais antiga.

  • Cada item — V1Action

    • idstring
    • object"action"
      • sempre "action"
    • statusstring

      pending_approval (esperando o dono), done, rejected (veja rejectionReason), expired (ninguém decidiu no prazo) ou failed (aprovada, mas a execução falhou — veja error). approved/executing são instantes de transição.

      • um de"pending_approval""approved""executing""done""rejected""expired""failed"
    • actionTypestring

      O verbo do Núcleo (contact.update, opportunity.move…).

    • approvalAreastring | null

      A área do dial de autonomia que governou o pedido (null = interna).

    • createdAtstring
    • expiresAtstring | null

      Até quando o dono pode decidir. null = a Ação nunca ficou pendente.

    • decidedAtstring | null
    • rejectionReasonstring | null
    • errorstring | null

    • O recurso que a Ação tocou (contact, opportunity…), quando houver.

      • typestring
      • idstring
  • nextCursorstring | null

    Cursor opaco da PRÓXIMA página — passe em ?cursor=. null = acabou a lista.