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

# List Agents - GET /v1/workspaces/:workspace_id/agents

> Return agents visible to the caller via GET /v1/workspaces/:workspace_id/agents. Minimum role viewer.

Return the Agent Loadouts visible to the current user in a workspace.

## Endpoint

```http theme={null}
GET /v1/workspaces/:workspace_id/agents
```

## Authentication

`Authorization: Bearer <jwt>` or `X-API-Key <sk_...>`. Minimum role: **viewer**.

## Path parameters

**workspace\_id** `string` *required*

Workspace id.

## Response

The response is an array; each element is an agent (fields identical to [Create Agent](https://docs.ariacompute.com/api-reference/memo/agents/create.md)).

## Example

```bash cURL theme={null}
curl https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/agents \
  -H "Authorization: Bearer <jwt>"
```

```json 200 theme={null}
[
  {
    "id": "agent_01a2b3c4d5e6",
    "workspace_id": "ws_01a2b3c4d5e6",
    "owner_id": "usr_01a2b3c4d5e6",
    "name": "Doc Assistant",
    "description": "Answers from the KB",
    "prompt": "You are a doc assistant.",
    "tools": ["rag"],
    "visibility": "private",
    "created_at": "2026-10-12T12:00:00Z",
    "updated_at": "2026-10-12T12:00:00Z"
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.