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

# V1 REST API

> Developer API for managing projects, agents, pathways, and tools

The V1 REST API provides full programmatic access to manage your Pathors projects. All endpoints use **Developer Key** authentication.

## Base URL

```
https://api.pathors.com/v1
```

## Authentication

All V1 API requests require a Developer Key passed via the `Authorization` header:

```bash theme={null}
Authorization: Bearer dk_your_developer_key_here
```

Developer keys can be created from the Pathors dashboard under **Developer Keys**.

## Resources

<CardGroup cols={2}>
  <Card title="Projects" icon="folder" href="/en/api-reference/v1/projects/list-projects">
    Create and manage projects.
  </Card>

  <Card title="Agent Config" icon="robot" href="/en/api-reference/v1/agent/get-agent">
    Configure agent settings (global prompt, execution mode, etc.).
  </Card>

  <Card title="Pathway" icon="diagram-project" href="/en/api-reference/v1/pathway/get-pathway">
    Read and modify conversation flow graphs (nodes and edges).
  </Card>

  <Card title="Tools" icon="wrench" href="/en/api-reference/v1/tools/list-tools">
    Manage tools available to the agent.
  </Card>

  <Card title="Calls" icon="phone" href="/en/api-reference/v1/calls/create-outbound-call">
    Initiate outbound phone calls.
  </Card>
</CardGroup>

## Error Format

All errors follow a consistent format:

```json theme={null}
{
  "error": {
    "message": "Description of the error",
    "details": {}
  }
}
```

| Status Code | Description                      |
| ----------- | -------------------------------- |
| 400         | Validation error                 |
| 401         | Invalid or missing developer key |
| 403         | Insufficient permissions         |
| 404         | Resource not found               |
| 409         | Conflict (e.g., duplicate ID)    |
| 500         | Internal server error            |