# Tray.ai Agent Instances API

**Canonical:** https://apis.io/apis/tray-ai/tray-ai-agent-instances-api/  
**Provider:** Tray.ai — https://apis.io/providers/tray-ai/  
**Base URL:** https://tray.io/graphql  
**Documentation:** https://tray.ai/documentation/developer/openapi/embeddedapi-introduction/

Tray.ai Agent Instances API is one of 15 APIs that [Tray.ai](https://apis.io/providers/tray-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include agent-instances. The published artifact set on APIs.io includes an OpenAPI specification.

{'$ref': 'descriptions/trayapi/tags/agent-instances.md'}

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/core/v1/workspaces/{workspace-id}/on-prem-agent-groups/{agent-group-id}/agents` | List Agents |
| POST | `/core/v1/workspaces/{workspace-id}/on-prem-agent-groups/{agent-group-id}/agents` | Create Agent |
| GET | `/core/v1/workspaces/{workspace-id}/on-prem-agent-groups/{agent-group-id}/agents/{agent-id}` | Retrieve Agent |
| PATCH | `/core/v1/workspaces/{workspace-id}/on-prem-agent-groups/{agent-group-id}/agents/{agent-id}` | Update Agent |
| DELETE | `/core/v1/workspaces/{workspace-id}/on-prem-agent-groups/{agent-group-id}/agents/{agent-id}` | Delete Agent |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/openapi/tray-ai-agent-instances-api-openapi.yml

## Other Tray.ai APIs (12)

- [Tray.ai Authentication API](https://apis.io/apis/tray-ai/tray-ai-authentication-api/)
- [Tray.ai Authentications API](https://apis.io/apis/tray-ai/tray-ai-authentications-api/)
- [Tray.ai Call Connector API](https://apis.io/apis/tray-ai/tray-ai-call-connector-api/)
- [Tray.ai Connectors API](https://apis.io/apis/tray-ai/tray-ai-connectors-api/)
- [Tray.ai Deployments API](https://apis.io/apis/tray-ai/tray-ai-deployments-api/)
- [Tray.ai Projects API](https://apis.io/apis/tray-ai/tray-ai-projects-api/)
- [Tray.ai Solution Instances API](https://apis.io/apis/tray-ai/tray-ai-solution-instances-api/)
- [Tray.ai Solutions API](https://apis.io/apis/tray-ai/tray-ai-solutions-api/)
- [Tray.ai Triggers API](https://apis.io/apis/tray-ai/tray-ai-triggers-api/)
- [Tray.ai Users API](https://apis.io/apis/tray-ai/tray-ai-users-api/)
- [Tray.ai Workflows API](https://apis.io/apis/tray-ai/tray-ai-workflows-api/)
- [Tray.ai Workspaces API](https://apis.io/apis/tray-ai/tray-ai-workspaces-api/)

## Tags

agent-instances

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/tray-ai/tray-ai-agent-instances-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/tray-ai/.