---
title: "Get an Agent."
method: GET
path: "/v1/agents/{id}"
tags: ["agents"]
---

# Get an Agent.

`GET /v1/agents/{id}`

Retrieve a specific Agent by its unique identifier.

## Path parameters

- `id` string, required

## Response `200`

Agent retrieved successfully.

- AgentView — An Agent represents a registered AI agent entity.
  - `id` string, required — The unique identifier of the Agent.
  - `name` string, required — The name of the Agent.
  - `is_public` boolean, required — Whether the Agent is publicly accessible.
  - `source` AgentSource — Agent source configuration.
    - `type` string, required — Source type: npm, pip, object, or git
    - `npm` NpmSource — NPM-based agent source configuration.
      - `package_name` string, required — NPM package name
      - `npm_version` string, nullable — NPM version constraint
      - `registry_url` string, nullable — NPM registry URL
    - `pip` PipSource — Pip-based agent source configuration.
      - `package_name` string, required — Pip package name
      - `pip_version` string, nullable — Pip version constraint
      - `registry_url` string, nullable — Pip registry URL
    - `object` ObjectSource — Object store agent source configuration.
      - `object_id` string, required — Object ID
      - `unpack_target` string, required — Where to unpack the object contents
    - `git` GitSource — Git-based agent source configuration.
      - `repository` string, required — Git repository URL
      - `ref` string, nullable — Git ref (branch/tag/commit)
      - `subpath` string, nullable — Path within repository
      - `auth_token` string, nullable — Authentication token

## Other responses

- `401` — Unauthorized. Invalid or missing authentication.
- `403` — Forbidden. Account does not have devbox capability.
- `404` — Agent not found.
- `500` — Internal server error.

---

[API](https://skmtc.dev/runloopai/apis/runloop-api.md) · [All operations](https://skmtc.dev/runloopai/apis/runloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runloopai/runloop-api/revisions/436b4f5c7426/schema)