# Askpilot Public API

Askpilot lets you create and run workflows. Use our API to trigger workflows from your own systems.

## What you can do with the API

With the API you can list the workflows in your organization and trigger any of them. That means a workflow you have set up in Askpilot can be started from your own systems: a CRM, a booking tool, an internal app or anything else you use. More capabilities are coming soon.

To learn more about how workflows are started through the API, see the [Workflows](https://askpilot.com/docs/developers/workflows.html) page.

## Get your API key

Keys are created and managed in the Askpilot app. Below is a step by step guide on how to create one and use it safely.

1. **Open the API settings.** In the Askpilot app, go to Settings → API.
2. **Create a key.** Click Create key, give it a name and select its scopes, then copy it straight away. The key is only shown once. To find a workflow's ID the key needs the `workflows:read` scope, and to start one it needs `workflows:write`.
3. **Send it as a Bearer token.** Put the key in the `Authorization` header of every request: `Authorization: Bearer <key>`.
4. **Keep it secret.** Treat the key like a password. Load it from an environment variable or a secrets vault on your own servers, and never put it in client-side code, version control or logs. If a key is exposed, revoke it in Settings → API and create a new one.

## Use the API

Every endpoint, with request and response examples, is in the reference. If you work with Python, an official SDK is available.

- [API reference](https://public-api.askpilot.com/docs#/): Every endpoint, with request and response examples and a console to try calls.
- [OpenAPI spec](https://public-api.askpilot.com/openapi.json): Import it into Postman, generate a client, or hand it to your AI agent.
- [Python SDK](https://github.com/Askpilot-AI-Number/public-api-python-client-sdk): The official Python client. Install it with pip or uv.

Have any questions about the API? Email [support@askpilot.com](mailto:support@askpilot.com).

---
This is the Markdown version of https://askpilot.com/docs/developers/. The whole documentation as one file: https://askpilot.com/docs/llms-full.txt