---
title: "Fetch an agent by id"
method: GET
path: "/agents/{agentId}"
tags: ["agents"]
---

# Fetch an agent by id

`GET /agents/{agentId}`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/agents/{agentId}`
- Auth: none declared

## Path parameters

- `agentId` string, required

## Response `200`

Agent

- Agent
  - `id` string, required
  - `orgId` string, required
  - `name` string, required
  - `role` 'researcher' | 'planner' | 'builder' | 'reviewer' | 'deployer' | 'tester', required
  - `harness` 'hermes' | 'pi' | 'kilo-code' | 'open-code' | 'claude-code' | 'codex' | 'copilot', required
  - `model` string, required
  - `effort` string, nullable, required
  - `sandboxTemplateId` string, required
  - `userPrompt` string, nullable, required: Deprecated: not read by the pipeline; agent instructions and skills are configured in the target repo.
  - `skillRepos` string[], required: Deprecated: not read by the pipeline; agent instructions and skills are configured in the target repo.
  - `isBuiltin` boolean, required
  - `createdAt` integer, required
  - `updatedAt` integer, required

## Other responses

- `404`: Not found

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)