---
title: "Retrieve agent"
method: GET
path: "/agents/{agent_id}"
tags: ["Agents"]
---

# Retrieve agent

`GET /agents/{agent_id}`

Retrieve a single agent by ID.

## Path parameters

- `agent_id` string, required

## Response `200`

The requested agent.

- object
  - `agent` object
    - `id` string
    - `name` string
    - `description` string, nullable
    - `team_id` string
    - `is_active` boolean
    - `tools` object[] — Tools the agent can call. Secret references are stripped and MCP server URLs are redacted before being returned.
    - `metadata` object
    - `model_name` string, nullable
    - `system_prompt` string, nullable
    - `resources` object[]
    - `skill_ids` string[], nullable — IDs of skills attached to the agent. `null` on surfaces that don't include them (e.g. the list endpoint); `[]` when none are attached. Manage with `PATCH /agents/{agent_id}/skills`.
    - `folder_id` string, nullable
    - `type` string, nullable — Internal agent type discriminator.
    - `created_at` string, date-time, nullable
    - `active_trigger_count` integer, nullable — Number of active triggers on this agent. Populated on list responses; may be `null` here.
    - `creator` object, nullable — User who created the agent. `null` when the creator is not known.
      - `id` string, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `email` string, nullable
      - `profile_picture` string, nullable

## Other responses

- `401` — Unauthorized — missing or invalid API key.
- `403` — Forbidden — the caller does not have read access to this agent.
- `404` — Agent not found.
- `500` — Internal server error.

---

[API](https://skmtc.dev/gumloop/apis/public-api.md) · [All operations](https://skmtc.dev/gumloop/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gumloop/public-api/revisions/115f2d6ce387/schema)