> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paradime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Triggering from the API

Programmable Agents can be triggered from your own code over GraphQL or with the Paradime Python SDK. The endpoints are the same — pick whichever fits your stack.

* [**GraphQL**](/developers/graphql-api/api-reference/dinoai-programmable-agents-api) — full reference and cURL examples in Developers → GraphQL API → DinoAI Programmable Agents API.
* [**Python SDK**](/developers/python-sdk/modules/dinoai-programmable-agents) — full reference and Python examples in Developers → Python SDK → DinoAI Programmable Agents.

<Info>
  **Prerequisites:**

  * An agent defined under .dinoai/agents/.yml in your repository — see YAML Configuration.
  * An API key with DinoAI Agent capabilities.
</Info>

#### GraphQL — quick example

```bash theme={"system"}
curl -X POST $PARADIME_API_ENDPOINT \
  -H "X-API-KEY: $PARADIME_API_KEY" \
  -H "X-API-SECRET: $PARADIME_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation Trigger($agent: String, $message: String) { triggerDinoaiAgentRun(agent: $agent, message: $message) { ok agentSessionId status } }",
    "variables": {"agent": "data-quality-checker", "message": "Focus on stg_orders"}
  }'
```

Save the returned `agentSessionId` and poll with `dinoaiAgentRun(agentSessionId: $id)` until `status` reaches `COMPLETED` or `FAILED`. See the full GraphQL reference for the trigger, poll, and follow-up operations.

***

#### Python SDK — quick example

```python theme={"system"}
from paradime import Paradime

paradime = Paradime(api_endpoint="API_ENDPOINT", api_key="API_KEY", api_secret="API_SECRET")

# Trigger a named agent and block until it completes
run = paradime.dinoai_agents.trigger_and_wait(
    agent="data-quality-checker",
    message="Focus on stg_orders",
)

for msg in run.messages:
    print(f"[{msg.role}] {msg.content}")
```

See the full Python SDK reference for `trigger_run`, `trigger_and_wait`, `send_message`, and `get_run`.

#### Related

* [Quick Start](/products/dino-ai/programmable-agents/index) — End-to-end first-run walkthrough
* [Triggering from Bolt](/products/dino-ai/programmable-agents/triggering-from-bolt) — Alternative invocation path via a Bolt schedule
* [Agent-to-Agent Delegation](/products/dino-ai/programmable-agents/agent-to-agent-delegation) — Multi-agent workflows


## Related topics

- [Triggering from Bolt](/products/dino-ai/programmable-agents/triggering-from-bolt.md)
- [Bolt API](/products/bolt/bolt-api.md)
- [Retrying a Failed Run](/products/bolt/managing-schedules/retrying-a-failed-run.md)
- [Translation of Key Terms](/guides/migrations/dbt-cloud-tm-importer/translation-of-key-terms.md)
- [Airbyte Cloud](/integrations/airbyte/airbyte-cloud.md)