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

# Agent Studio Overview

> List, retrieve, and execute AI agents built in Agent Studio using the HoopAI Agent Studio REST API.

The Agent Studio API lets you programmatically interact with AI agents built in the HoopAI Agent Studio. Use it to list available agents, retrieve agent details, and execute agents to get AI-powered responses — all through a simple REST interface.

## Base URL

```
https://services.leadconnectorhq.com
```

## Authentication

All endpoints require a Bearer token and an API version header.

```bash theme={null}
Authorization: Bearer <access_token>
Version: 2021-04-15
```

See [OAuth 2.0](/api-reference/oauth/authorization) to obtain an access token.

## OAuth scopes

| Scope                   | Access                   |
| ----------------------- | ------------------------ |
| `agent-studio.readonly` | List and retrieve agents |
| `agent-studio.write`    | Execute agents           |

## Quick start

Execute an agent and get a response:

```bash theme={null}
curl -X POST https://services.leadconnectorhq.com/agent-studio/public-api/agents/agent_abc123/execute \
  -H "Authorization: Bearer <access_token>" \
  -H "Version: 2021-04-15" \
  -H "Content-Type: application/json" \
  -d '{
    "locationId": "ve9EPM428h8vShlRW1KT",
    "message": "What services do you offer?",
    "contactId": "contact_abc123"
  }'
```

The response includes an `executionId` that you can pass in follow-up requests to maintain conversation context.

## Endpoints

| Method | Path                                                | Description                    |
| ------ | --------------------------------------------------- | ------------------------------ |
| `GET`  | `/agent-studio/public-api/agents`                   | List all agents for a location |
| `GET`  | `/agent-studio/public-api/agents/{agentId}`         | Get agent details by ID        |
| `POST` | `/agent-studio/public-api/agents/{agentId}/execute` | Execute an agent               |

## Related

* [Conversation AI API](/api-reference/conversation-ai/overview) — Manage conversation bots and training
* [Knowledge Base API](/api-reference/knowledge-base/overview) — Train knowledge bases that agents can reference
* [Contacts API](/api-reference/contacts/overview) — Look up contacts associated with agent conversations