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

# Get an agent

`GET /agents/{uuid}`

## Request

- Base URL: `https://api.modjo.ai/v2`
- URL: `https://api.modjo.ai/v2/agents/{uuid}`
- Auth: HTTP bearer

Returns a single agent by UUID, including its instructions.

## Path parameters

- `uuid` string, uuid, required: Agent UUID

## Response `200`

Agent details

- Agent
  - `uuid` string, uuid, required: Agent UUID
  - `name` string, required: Agent name
  - `emoji` string, required: Agent emoji
  - `description` string, required: Short description of what the agent does
  - `instructions` string, required: Instructions the AI follows when the agent is used
  - `creatorOrigin` 'modjo' | 'user', required: Origin of the agent: `modjo` for agents provided by Modjo, which are read-only, `user` for agents created in your workspace
  - `enabledTools` string[], required: Tools the agent can use
  - `createdById` number, nullable, required: ID of the user who created the agent
  - `createdOn` string, nullable, required: Creation timestamp in ISO 8601 format
  - `modifiedOn` string, nullable, required: Last modification timestamp in ISO 8601 format

## Other responses

- `401`: Authentication failed. The API key is missing or invalid.
- `404`: Agent not found
- `429`: Rate limit exceeded. Retry after the X-RateLimit-Reset interval.

## Changes

- **2026-10-14** `5aa3b3f47a13`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/modjo/apis/modjo-public-api/changes/agents/:uuid/get.md)

---

[API](https://skmtc.dev/modjo/apis/modjo-public-api.md) - [All operations](https://skmtc.dev/modjo/apis/modjo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modjo/apis/modjo-public-api/revisions/9d2a0a6a5a20?raw)