> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/stackai-api.md).

# StackAI API

- [StackAI API developer guide](https://docs.stackai.com/stackai-api/stackai-api-developer-guide.md)
- [Quickstart](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/quickstart.md)
- [Authentication and authorization](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/authentication-and-authorization.md)
- [Requests, responses, pagination, and retries](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/requests-responses-pagination-and-retries.md)
- [Run workflows end to end](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/run-workflows-end-to-end.md)
- [Legacy inference, streaming, and analytics](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/legacy-inference-streaming-and-analytics.md)
- [Knowledge ingestion and search](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/knowledge-ingestion-and-search.md)
- [Providers, connections, and actions](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/providers-connections-and-actions.md)
- [Evaluations and monitors](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/evaluations-and-monitors.md)
- [Skills and versioned bundles](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/skills-and-versioned-bundles.md)
- [Webhooks and signed event delivery](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/webhooks-and-signed-event-delivery.md)
- [SCIM 2.0 provisioning](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/scim-2.0-provisioning.md)
- [Troubleshooting and production checklist](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/troubleshooting-and-production-checklist.md)
- [Versioning, coverage, and OpenAPI](https://docs.stackai.com/stackai-api/stackai-api-developer-guide/versioning-coverage-and-openapi.md)
- [REST API v2](https://docs.stackai.com/stackai-api/rest-api-v2.md)
- [Knowledge bases](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases.md)
- [GET /v2/knowledge-bases](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/get-v2-knowledge-bases.md)
- [POST /v2/knowledge-bases](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/post-v2-knowledge-bases.md)
- [GET /v2/knowledge-bases/{knowledge\_base\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/get-v2-knowledge-bases-knowledge_base_id.md)
- [PATCH /v2/knowledge-bases/{knowledge\_base\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/patch-v2-knowledge-bases-knowledge_base_id.md)
- [DELETE /v2/knowledge-bases/{knowledge\_base\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/delete-v2-knowledge-bases-knowledge_base_id.md)
- [GET /v2/knowledge-bases/{knowledge\_base\_id}/metadata-schemas](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/get-v2-knowledge-bases-knowledge_base_id-metadata-schemas.md)
- [GET /v2/knowledge-bases/{knowledge\_base\_id}/resources](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/get-v2-knowledge-bases-knowledge_base_id-resources.md)
- [POST /v2/knowledge-bases/{knowledge\_base\_id}/resources](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/post-v2-knowledge-bases-knowledge_base_id-resources.md)
- [GET /v2/knowledge-bases/{knowledge\_base\_id}/resources/{resource\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/get-v2-knowledge-bases-knowledge_base_id-resources-resource_id.md)
- [DELETE /v2/knowledge-bases/{knowledge\_base\_id}/resources/{resource\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/delete-v2-knowledge-bases-knowledge_base_id-resources-resource_id.md)
- [GET /v2/knowledge-bases/{knowledge\_base\_id}/resources/{resource\_id}/download](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/get-v2-knowledge-bases-knowledge_base_id-resources-resource_id-download.md)
- [POST /v2/knowledge-bases/{knowledge\_base\_id}/query](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/post-v2-knowledge-bases-knowledge_base_id-query.md)
- [POST /v2/knowledge-bases/{knowledge\_base\_id}/sync](https://docs.stackai.com/stackai-api/rest-api-v2/knowledge-bases/post-v2-knowledge-bases-knowledge_base_id-sync.md)
- [Project IO schemas](https://docs.stackai.com/stackai-api/rest-api-v2/project-io-schemas.md)
- [GET /v2/projects/{project\_id}/io-schema](https://docs.stackai.com/stackai-api/rest-api-v2/project-io-schemas/get-v2-projects-project_id-io-schema.md)
- [Evaluation datasets](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets.md)
- [GET /v2/evals/datasets](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/get-v2-evals-datasets.md)
- [POST /v2/evals/datasets](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/post-v2-evals-datasets.md)
- [GET /v2/evals/datasets/{dataset\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/get-v2-evals-datasets-dataset_id.md)
- [PATCH /v2/evals/datasets/{dataset\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/patch-v2-evals-datasets-dataset_id.md)
- [DELETE /v2/evals/datasets/{dataset\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/delete-v2-evals-datasets-dataset_id.md)
- [POST /v2/evals/datasets/{dataset\_id}/rows](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/post-v2-evals-datasets-dataset_id-rows.md)
- [GET /v2/evals/datasets/{dataset\_id}/rows](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/get-v2-evals-datasets-dataset_id-rows.md)
- [POST /v2/evals/datasets/{dataset\_id}/imports](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/post-v2-evals-datasets-dataset_id-imports.md)
- [GET /v2/evals/datasets/{dataset\_id}/rows/{row\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/get-v2-evals-datasets-dataset_id-rows-row_id.md)
- [PATCH /v2/evals/datasets/{dataset\_id}/rows/{row\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/patch-v2-evals-datasets-dataset_id-rows-row_id.md)
- [DELETE /v2/evals/datasets/{dataset\_id}/rows/{row\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/evaluation-datasets/delete-v2-evals-datasets-dataset_id-rows-row_id.md)
- [Evaluators and previews](https://docs.stackai.com/stackai-api/rest-api-v2/evaluators-and-previews.md)
- [GET /v2/evals/evaluators](https://docs.stackai.com/stackai-api/rest-api-v2/evaluators-and-previews/get-v2-evals-evaluators.md)
- [POST /v2/evals/evaluators](https://docs.stackai.com/stackai-api/rest-api-v2/evaluators-and-previews/post-v2-evals-evaluators.md)
- [GET /v2/evals/evaluators/{evaluator\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/evaluators-and-previews/get-v2-evals-evaluators-evaluator_id.md)
- [PATCH /v2/evals/evaluators/{evaluator\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/evaluators-and-previews/patch-v2-evals-evaluators-evaluator_id.md)
- [DELETE /v2/evals/evaluators/{evaluator\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/evaluators-and-previews/delete-v2-evals-evaluators-evaluator_id.md)
- [POST /v2/evals/evaluator-previews](https://docs.stackai.com/stackai-api/rest-api-v2/evaluators-and-previews/post-v2-evals-evaluator-previews.md)
- [GET /v2/evals/evaluator-templates](https://docs.stackai.com/stackai-api/rest-api-v2/evaluators-and-previews/get-v2-evals-evaluator-templates.md)
- [Experiments and jobs](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs.md)
- [GET /v2/evals/experiments](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs/get-v2-evals-experiments.md)
- [POST /v2/evals/experiments](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs/post-v2-evals-experiments.md)
- [GET /v2/evals/experiments/{experiment\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs/get-v2-evals-experiments-experiment_id.md)
- [PATCH /v2/evals/experiments/{experiment\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs/patch-v2-evals-experiments-experiment_id.md)
- [DELETE /v2/evals/experiments/{experiment\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs/delete-v2-evals-experiments-experiment_id.md)
- [GET /v2/evals/experiments/{experiment\_id}/rows](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs/get-v2-evals-experiments-experiment_id-rows.md)
- [GET /v2/evals/experiments/{experiment\_id}/status](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs/get-v2-evals-experiments-experiment_id-status.md)
- [POST /v2/evals/experiments/{experiment\_id}/jobs](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs/post-v2-evals-experiments-experiment_id-jobs.md)
- [GET /v2/evals/experiments/{experiment\_id}/jobs/{job\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/experiments-and-jobs/get-v2-evals-experiments-experiment_id-jobs-job_id.md)
- [Production monitors](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors.md)
- [GET /v2/evals/monitor-limits](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/get-v2-evals-monitor-limits.md)
- [GET /v2/evals/monitors](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/get-v2-evals-monitors.md)
- [POST /v2/evals/monitors](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/post-v2-evals-monitors.md)
- [GET /v2/evals/monitors/{monitor\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/get-v2-evals-monitors-monitor_id.md)
- [PATCH /v2/evals/monitors/{monitor\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/patch-v2-evals-monitors-monitor_id.md)
- [DELETE /v2/evals/monitors/{monitor\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/delete-v2-evals-monitors-monitor_id.md)
- [GET /v2/evals/monitors/{monitor\_id}/score-stats](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/get-v2-evals-monitors-monitor_id-score-stats.md)
- [GET /v2/evals/monitors/{monitor\_id}/alert](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/get-v2-evals-monitors-monitor_id-alert.md)
- [PATCH /v2/evals/monitors/{monitor\_id}/alert](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/patch-v2-evals-monitors-monitor_id-alert.md)
- [GET /v2/evals/monitors/{monitor\_id}/sampled-runs](https://docs.stackai.com/stackai-api/rest-api-v2/production-monitors/get-v2-evals-monitors-monitor_id-sampled-runs.md)
- [Run scores](https://docs.stackai.com/stackai-api/rest-api-v2/run-scores.md)
- [POST /v2/evals/runs/{run\_id}/scores](https://docs.stackai.com/stackai-api/rest-api-v2/run-scores/post-v2-evals-runs-run_id-scores.md)
- [GET /v2/evals/runs/{run\_id}/scores](https://docs.stackai.com/stackai-api/rest-api-v2/run-scores/get-v2-evals-runs-run_id-scores.md)
- [GET /v2/evals/scores/{score\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/run-scores/get-v2-evals-scores-score_id.md)
- [Providers and actions](https://docs.stackai.com/stackai-api/rest-api-v2/providers-and-actions.md)
- [GET /v2/providers](https://docs.stackai.com/stackai-api/rest-api-v2/providers-and-actions/get-v2-providers.md)
- [GET /v2/providers/{provider\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/providers-and-actions/get-v2-providers-provider_id.md)
- [GET /v2/providers/{provider\_id}/actions](https://docs.stackai.com/stackai-api/rest-api-v2/providers-and-actions/get-v2-providers-provider_id-actions.md)
- [GET /v2/providers/{provider\_id}/actions/{action\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/providers-and-actions/get-v2-providers-provider_id-actions-action_id.md)
- [GET /v2/providers/{provider\_id}/triggers](https://docs.stackai.com/stackai-api/rest-api-v2/providers-and-actions/get-v2-providers-provider_id-triggers.md)
- [GET /v2/providers/{provider\_id}/triggers/{trigger\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/providers-and-actions/get-v2-providers-provider_id-triggers-trigger_id.md)
- [POST /v2/providers/{provider\_id}/actions/{action\_id}/run](https://docs.stackai.com/stackai-api/rest-api-v2/providers-and-actions/post-v2-providers-provider_id-actions-action_id-run.md)
- [Connections](https://docs.stackai.com/stackai-api/rest-api-v2/connections.md)
- [GET /v2/connections](https://docs.stackai.com/stackai-api/rest-api-v2/connections/get-v2-connections.md)
- [Webhook subscriptions](https://docs.stackai.com/stackai-api/rest-api-v2/webhook-subscriptions.md)
- [POST /v2/webhooks/subscriptions](https://docs.stackai.com/stackai-api/rest-api-v2/webhook-subscriptions/post-v2-webhooks-subscriptions.md)
- [GET /v2/webhooks/subscriptions](https://docs.stackai.com/stackai-api/rest-api-v2/webhook-subscriptions/get-v2-webhooks-subscriptions.md)
- [DELETE /v2/webhooks/subscriptions/{subscription\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/webhook-subscriptions/delete-v2-webhooks-subscriptions-subscription_id.md)
- [Runs](https://docs.stackai.com/stackai-api/rest-api-v2/runs.md)
- [POST /v2/runs](https://docs.stackai.com/stackai-api/rest-api-v2/runs/post-v2-runs.md)
- [GET /v2/runs](https://docs.stackai.com/stackai-api/rest-api-v2/runs/get-v2-runs.md)
- [GET /v2/runs/{run\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/runs/get-v2-runs-run_id.md)
- [POST /v2/runs/{run\_id}/cancel](https://docs.stackai.com/stackai-api/rest-api-v2/runs/post-v2-runs-run_id-cancel.md)
- [POST /v2/runs/{run\_id}/resume](https://docs.stackai.com/stackai-api/rest-api-v2/runs/post-v2-runs-run_id-resume.md)
- [Skills and versions](https://docs.stackai.com/stackai-api/rest-api-v2/skills-and-versions.md)
- [GET /v2/skills](https://docs.stackai.com/stackai-api/rest-api-v2/skills-and-versions/get-v2-skills.md)
- [POST /v2/skills](https://docs.stackai.com/stackai-api/rest-api-v2/skills-and-versions/post-v2-skills.md)
- [GET /v2/skills/{skill\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/skills-and-versions/get-v2-skills-skill_id.md)
- [DELETE /v2/skills/{skill\_id}](https://docs.stackai.com/stackai-api/rest-api-v2/skills-and-versions/delete-v2-skills-skill_id.md)
- [GET /v2/skills/{skill\_id}/versions](https://docs.stackai.com/stackai-api/rest-api-v2/skills-and-versions/get-v2-skills-skill_id-versions.md)
- [POST /v2/skills/{skill\_id}/versions](https://docs.stackai.com/stackai-api/rest-api-v2/skills-and-versions/post-v2-skills-skill_id-versions.md)
- [GET /v2/skills/{skill\_id}/versions/{version}](https://docs.stackai.com/stackai-api/rest-api-v2/skills-and-versions/get-v2-skills-skill_id-versions-version.md)
- [Knowledge Bases v1](https://docs.stackai.com/stackai-api/knowledge-bases-v1.md)
- [Lifecycle, resources and sync](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync.md)
- [GET /v1/knowledge-bases/{knowledge\_base\_id}/resources](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/get-v1-knowledge-bases-knowledge_base_id-resources.md)
- [POST /v1/knowledge-bases/{knowledge\_base\_id}/resources](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/post-v1-knowledge-bases-knowledge_base_id-resources.md)
- [GET /v1/knowledge-bases/{knowledge\_base\_id}/resources/{resource\_id}](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/get-v1-knowledge-bases-knowledge_base_id-resources-resource_id.md)
- [DELETE /v1/knowledge-bases/{knowledge\_base\_id}/resources/{resource\_id}](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/delete-v1-knowledge-bases-knowledge_base_id-resources-resource_id.md)
- [POST /v1/knowledge-bases/{knowledge\_base\_id}/sync](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/post-v1-knowledge-bases-knowledge_base_id-sync.md)
- [GET /v1/knowledge-bases](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/get-v1-knowledge-bases.md)
- [POST /v1/knowledge-bases](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/post-v1-knowledge-bases.md)
- [GET /v1/knowledge-bases/{knowledge\_base\_id}](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/get-v1-knowledge-bases-knowledge_base_id.md)
- [PATCH /v1/knowledge-bases/{knowledge\_base\_id}](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/patch-v1-knowledge-bases-knowledge_base_id.md)
- [DELETE /v1/knowledge-bases/{knowledge\_base\_id}](https://docs.stackai.com/stackai-api/knowledge-bases-v1/lifecycle-resources-and-sync/delete-v1-knowledge-bases-knowledge_base_id.md)
- [Legacy inference and analytics](https://docs.stackai.com/stackai-api/legacy-inference-and-analytics.md)
- [Inference v0](https://docs.stackai.com/stackai-api/legacy-inference-and-analytics/inference-v0.md)
- [GET /inference/v0/runs/{org\_id}/{run\_id}](https://docs.stackai.com/stackai-api/legacy-inference-and-analytics/inference-v0/get-inference-v0-runs-org_id-run_id.md)
- [POST /inference/v0/runs/{org\_id}/{run\_id}/resume](https://docs.stackai.com/stackai-api/legacy-inference-and-analytics/inference-v0/post-inference-v0-runs-org_id-run_id-resume.md)
- [POST /inference/v0/run/{org\_id}/{flow\_id}](https://docs.stackai.com/stackai-api/legacy-inference-and-analytics/inference-v0/post-inference-v0-run-org_id-flow_id.md)
- [Analytics](https://docs.stackai.com/stackai-api/legacy-inference-and-analytics/analytics.md)
- [GET /analytics/org/{org\_id}/flows/{flow\_id}](https://docs.stackai.com/stackai-api/legacy-inference-and-analytics/analytics/get-analytics-org-org_id-flows-flow_id.md)
- [Models](https://docs.stackai.com/stackai-api/models.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.stackai.com/stackai-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.