---
title: "Get agent"
method: GET
path: "/agent/v1/agents/{id}"
tags: ["Agents"]
---

# Get agent

`GET /agent/v1/agents/{id}`

Retrieves a single agent definition by ID.

## Path parameters

- `id` string, required

## Response `200`

Agent details

- object
  - `id` string
  - `name` string
  - `description` string, nullable
  - `instructions` string
  - `model` string
  - `vaultIds` string[], nullable
  - `enabledTools` string[], nullable
  - `disabledTools` string[], nullable
  - `sandbox` object, nullable
  - `isActive` boolean
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400` — Missing agent ID
- `401` — Invalid API key
- `403` — No agent access
- `404` — Agent not found

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/versions/5b7e64e6d6f9/schema)