> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://humanloop.com/docs/v5/api/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://humanloop.com/docs/_mcp/server.

The Humanloop API allows you to interact with Humanloop and model providers programmatically.

You can do this through HTTP requests from any language or via our official Python or TypeScript SDK.

<Accordion title="Install and initialize the SDK">

First you need to install and initialize the SDK. If you have already done this, skip to the next section.

Open up your terminal and follow these steps:

1. Install the Humanloop SDK:
<CodeBlock>
```python
pip install humanloop
```

```typescript
npm install humanloop
```
</CodeBlock>

2. Initialize the SDK with your Humanloop API key (you can get it from the [Organization Settings page](https://app.humanloop.com/account/api-keys)).
<CodeBlock>
```python
from humanloop import Humanloop
humanloop = Humanloop(api_key="<YOUR HUMANLOOP KEY>")

# Check that the authentication was successful
print(humanloop.prompts.list())
```

```typescript
import { HumanloopClient, Humanloop } from "humanloop";

const humanloop = new HumanloopClient({ apiKey: "YOUR_API_KEY" });

// Check that the authentication was successful
console.log(await humanloop.prompts.list());
```
</CodeBlock>

</Accordion>


Guides and further details about key concepts can be found in [our docs](/docs/getting-started/overview).


## API Docs

- API > Prompts [Log to a Prompt](https://humanloop.com/docs/api/prompts/log.md)
- API > Prompts [Update Prompt Log](https://humanloop.com/docs/api/prompts/update-log.md)
- API > Prompts [Call Prompt](https://humanloop.com/docs/api/prompts/call.md)
- API > Prompts [List Prompts](https://humanloop.com/docs/api/prompts/list.md)
- API > Prompts [Upsert Prompt](https://humanloop.com/docs/api/prompts/upsert.md)
- API > Prompts [Get Prompt](https://humanloop.com/docs/api/prompts/get.md)
- API > Prompts [Delete Prompt](https://humanloop.com/docs/api/prompts/delete.md)
- API > Prompts [Move Prompt](https://humanloop.com/docs/api/prompts/move.md)
- API > Prompts [Populate Prompt template](https://humanloop.com/docs/api/prompts/populate.md)
- API > Prompts [List Versions of a Prompt](https://humanloop.com/docs/api/prompts/list-versions.md)
- API > Prompts [Delete Prompt Version](https://humanloop.com/docs/api/prompts/delete-prompt-version.md)
- API > Prompts [Update Prompt Version](https://humanloop.com/docs/api/prompts/patch-prompt-version.md)
- API > Prompts [Deploy Prompt](https://humanloop.com/docs/api/prompts/set-deployment.md)
- API > Prompts [Remove Deployment](https://humanloop.com/docs/api/prompts/remove-deployment.md)
- API > Prompts [List a Prompt's Environments](https://humanloop.com/docs/api/prompts/list-environments.md)
- API > Prompts [Update Monitoring](https://humanloop.com/docs/api/prompts/update-monitoring.md)
- API > Prompts [Serialize](https://humanloop.com/docs/api/prompts/serialize.md)
- API > Prompts [Deserialize](https://humanloop.com/docs/api/prompts/deserialize.md)
- API > Agents [Log to an Agent](https://humanloop.com/docs/api/agents/log.md)
- API > Agents [Update Agent Log](https://humanloop.com/docs/api/agents/update-log.md)
- API > Agents [Call Agent](https://humanloop.com/docs/api/agents/call.md)
- API > Agents [Continue Agent Call](https://humanloop.com/docs/api/agents/continue-call.md)
- API > Agents [List Agents](https://humanloop.com/docs/api/agents/list.md)
- API > Agents [Upsert Agent](https://humanloop.com/docs/api/agents/upsert.md)
- API > Agents [Delete Agent Version](https://humanloop.com/docs/api/agents/delete-agent-version.md)
- API > Agents [Update Agent Version](https://humanloop.com/docs/api/agents/patch-agent-version.md)
- API > Agents [Get Agent](https://humanloop.com/docs/api/agents/get.md)
- API > Agents [Delete Agent](https://humanloop.com/docs/api/agents/delete.md)
- API > Agents [Move Agent](https://humanloop.com/docs/api/agents/move.md)
- API > Agents [List Versions of a Agent](https://humanloop.com/docs/api/agents/list-versions.md)
- API > Agents [Deploy Agent](https://humanloop.com/docs/api/agents/set-deployment.md)
- API > Agents [Remove Deployment](https://humanloop.com/docs/api/agents/remove-deployment.md)
- API > Agents [List an Agent's Environments](https://humanloop.com/docs/api/agents/list-environments.md)
- API > Agents [Update Monitoring](https://humanloop.com/docs/api/agents/update-monitoring.md)
- API > Agents [Serialize](https://humanloop.com/docs/api/agents/serialize.md)
- API > Agents [Deserialize](https://humanloop.com/docs/api/agents/deserialize.md)
- API > Flows [Log to a Flow](https://humanloop.com/docs/api/flows/log.md)
- API > Flows [Update Flow Log](https://humanloop.com/docs/api/flows/update-log.md)
- API > Flows [Get Flow](https://humanloop.com/docs/api/flows/get.md)
- API > Flows [Delete Flow](https://humanloop.com/docs/api/flows/delete.md)
- API > Flows [Move Flow](https://humanloop.com/docs/api/flows/move.md)
- API > Flows [List Flows](https://humanloop.com/docs/api/flows/list.md)
- API > Flows [Upsert Flow](https://humanloop.com/docs/api/flows/upsert.md)
- API > Flows [List Versions of a Flow](https://humanloop.com/docs/api/flows/list-versions.md)
- API > Flows [Delete Flow Version](https://humanloop.com/docs/api/flows/delete-flow-version.md)
- API > Flows [Update Flow Version](https://humanloop.com/docs/api/flows/update-flow-version.md)
- API > Flows [Deploy Flow](https://humanloop.com/docs/api/flows/set-deployment.md)
- API > Flows [Remove Deployment](https://humanloop.com/docs/api/flows/remove-deployment.md)
- API > Flows [List a Flow's Environments](https://humanloop.com/docs/api/flows/list-environments.md)
- API > Flows [Update Monitoring](https://humanloop.com/docs/api/flows/update-monitoring.md)
- API > Evaluators [Submit Evaluator Judgment](https://humanloop.com/docs/api/evaluators/log.md)
- API > Evaluators [List Evaluators](https://humanloop.com/docs/api/evaluators/list.md)
- API > Evaluators [Upsert Evaluator](https://humanloop.com/docs/api/evaluators/upsert.md)
- API > Evaluators [Get Evaluator](https://humanloop.com/docs/api/evaluators/get.md)
- API > Evaluators [Delete Evaluator](https://humanloop.com/docs/api/evaluators/delete.md)
- API > Evaluators [Move Evaluator](https://humanloop.com/docs/api/evaluators/move.md)
- API > Evaluators [List Versions of an Evaluator](https://humanloop.com/docs/api/evaluators/list-versions.md)
- API > Evaluators [Delete Evaluator Version](https://humanloop.com/docs/api/evaluators/delete-evaluator-version.md)
- API > Evaluators [Update Evaluator Version](https://humanloop.com/docs/api/evaluators/update-evaluator-version.md)
- API > Evaluators [Deploy Evaluator](https://humanloop.com/docs/api/evaluators/set-deployment.md)
- API > Evaluators [Remove Deployment](https://humanloop.com/docs/api/evaluators/remove-deployment.md)
- API > Evaluators [List an Evaluator's Environments](https://humanloop.com/docs/api/evaluators/list-environments.md)
- API > Evaluators [Update Monitoring](https://humanloop.com/docs/api/evaluators/update-monitoring.md)
- API > Datasets [List Datasets](https://humanloop.com/docs/api/datasets/list.md)
- API > Datasets [Upsert Dataset](https://humanloop.com/docs/api/datasets/upsert.md)
- API > Datasets [Get Dataset](https://humanloop.com/docs/api/datasets/get.md)
- API > Datasets [Delete Dataset](https://humanloop.com/docs/api/datasets/delete.md)
- API > Datasets [Move Dataset](https://humanloop.com/docs/api/datasets/move.md)
- API > Datasets [List Datapoints](https://humanloop.com/docs/api/datasets/list-datapoints.md)
- API > Datasets [List Versions of a Dataset](https://humanloop.com/docs/api/datasets/list-versions.md)
- API > Datasets [Delete Dataset Version](https://humanloop.com/docs/api/datasets/delete-dataset-version.md)
- API > Datasets [Update Dataset Version](https://humanloop.com/docs/api/datasets/update-dataset-version.md)
- API > Datasets [Upload CSV](https://humanloop.com/docs/api/datasets/upload-csv.md)
- API > Datasets [Deploy Dataset](https://humanloop.com/docs/api/datasets/set-deployment.md)
- API > Datasets [Remove Deployment](https://humanloop.com/docs/api/datasets/remove-deployment.md)
- API > Datasets [List a Dataset's Environments](https://humanloop.com/docs/api/datasets/list-environments.md)
- API > Evaluations [List Evaluations](https://humanloop.com/docs/api/evaluations/list.md)
- API > Evaluations [Create Evaluation](https://humanloop.com/docs/api/evaluations/create.md)
- API > Evaluations [Add Evaluators](https://humanloop.com/docs/api/evaluations/add-evaluators.md)
- API > Evaluations [Remove Evaluator](https://humanloop.com/docs/api/evaluations/remove-evaluator.md)
- API > Evaluations [Get Evaluation](https://humanloop.com/docs/api/evaluations/get.md)
- API > Evaluations [Delete Evaluation](https://humanloop.com/docs/api/evaluations/delete.md)
- API > Evaluations [List Runs for Evaluation](https://humanloop.com/docs/api/evaluations/list-runs-for-evaluation.md)
- API > Evaluations [Create Run](https://humanloop.com/docs/api/evaluations/create-run.md)
- API > Evaluations [Add Existing Run](https://humanloop.com/docs/api/evaluations/add-existing-run.md)
- API > Evaluations [Remove Run](https://humanloop.com/docs/api/evaluations/remove-run.md)
- API > Evaluations [Update Evaluation Run](https://humanloop.com/docs/api/evaluations/update-evaluation-run.md)
- API > Evaluations [Add Logs to Run](https://humanloop.com/docs/api/evaluations/add-logs-to-run.md)
- API > Evaluations [Get Evaluation Stats](https://humanloop.com/docs/api/evaluations/get-stats.md)
- API > Evaluations [Get Logs for Evaluation](https://humanloop.com/docs/api/evaluations/get-logs.md)
- API > Tools [Call Tool](https://humanloop.com/docs/api/tools/call.md)
- API > Tools [Log to a Tool](https://humanloop.com/docs/api/tools/log.md)
- API > Tools [Update Tool Log](https://humanloop.com/docs/api/tools/update.md)
- API > Tools [List Tools](https://humanloop.com/docs/api/tools/list.md)
- API > Tools [Upsert Tool](https://humanloop.com/docs/api/tools/upsert.md)
- API > Tools [Get Tool](https://humanloop.com/docs/api/tools/get.md)
- API > Tools [Delete Tool](https://humanloop.com/docs/api/tools/delete.md)
- API > Tools [Move Tool](https://humanloop.com/docs/api/tools/move.md)
- API > Tools [List Versions of a Tool](https://humanloop.com/docs/api/tools/list-versions.md)
- API > Tools [Delete Tool Version](https://humanloop.com/docs/api/tools/delete-tool-version.md)
- API > Tools [Update Tool Version](https://humanloop.com/docs/api/tools/update-tool-version.md)
- API > Tools [Deploy Tool](https://humanloop.com/docs/api/tools/set-deployment.md)
- API > Tools [Remove Deployment](https://humanloop.com/docs/api/tools/remove-deployment.md)
- API > Tools [List a Tool's Environments](https://humanloop.com/docs/api/tools/list-environments.md)
- API > Tools [Update Monitoring](https://humanloop.com/docs/api/tools/update-monitoring.md)
- API > Tools [Get Environment Variables](https://humanloop.com/docs/api/tools/get-environment-variables.md)
- API > Tools [Add Environment Variable](https://humanloop.com/docs/api/tools/add-environment-variable.md)
- API > Tools [Delete Environment Variable](https://humanloop.com/docs/api/tools/delete-environment-variable.md)
- API > Files [List Files](https://humanloop.com/docs/api/files/list-files.md)
- API > Files [Retrieve by path](https://humanloop.com/docs/api/files/retrieve-by-path.md)
- API > Directories [List ](https://humanloop.com/docs/api/directories/list.md)
- API > Directories [Create](https://humanloop.com/docs/api/directories/create.md)
- API > Directories [Get](https://humanloop.com/docs/api/directories/get.md)
- API > Directories [Delete](https://humanloop.com/docs/api/directories/delete.md)
- API > Directories [Update](https://humanloop.com/docs/api/directories/update.md)
- API > Logs [List Logs](https://humanloop.com/docs/api/logs/list.md)
- API > Logs [Delete Logs](https://humanloop.com/docs/api/logs/delete.md)
- API > Logs [Get Log](https://humanloop.com/docs/api/logs/get.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://humanloop.com/docs/v5/api/openapi.json)
- [OpenAPI YAML](https://humanloop.com/docs/v5/api/openapi.yaml)