Listar gatilhos de agenda
Os gatilhos de agenda do agente: agendamento semanal, recorrência e disparo único. Exige `configure` no agente, avaliado como a pessoa da chave. Exige o escopo triggers:read.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Path Parameters
Id ou apelido do agente.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agents/string/triggers"{ "triggers": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978", "name": "string", "kind": "schedule", "message": "string", "enabled": true, "schedule_days": [ "mon" ], "schedule_time": "string", "schedule_timezone": "string", "recurring_interval": 1, "recurring_unit": "minutes", "run_at": "2019-08-24T14:15:22Z", "return_channel": "web", "telegram_handle": "string", "resume_last_thread": true, "target_thread_id": "20348137-b265-4ef4-aee7-500a6c048ee0", "last_run_at": "2019-08-24T14:15:22Z", "next_run_at": "2019-08-24T14:15:22Z", "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ]}Ler o ranking de consumo da organização da chave
O lado servidor do Leaderboard multi-org: a organização que emitiu esta chave expõe por aqui o próprio ranking de consumo, para que outra organização possa incluí-lo no painel dela. Não há parâmetro de organização: a chave pertence a uma, e é dela que se fala. O ranking é lido com a permissão de QUEM EMITIU a chave — o que sai daqui é o que essa pessoa vê no próprio painel, nem mais nem menos. Responde 404 quando a organização desligou o leaderboard em Configurações: a decisão vale para os dados, e não só para a tela. Exige o escopo leaderboard:read.
Criar gatilho de agenda
Cria um gatilho de agenda. Quem a chave representa responde pelos disparos (`created_by`), e a cada disparo o agente confere se essa pessoa ainda pode usá-lo. O próximo disparo (`next_run_at`) é calculado aqui. Exige o escopo triggers:write.