---
title: "Scan Template Source"
method: POST
path: "/agent-templates/sources/scan"
tags: ["Workflows"]
---

# Scan Template Source

`POST /agent-templates/sources/scan`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/agent-templates/sources/scan`
- Auth: API key in header `Authorization`

## Request body

- TemplateSourceScanRequest
  - `repo_url` string, required

## Response `200`

Successful Response

- TemplateRepositoryScan
  - `repo_url` string, required
  - `commit` string, required
  - `templates` TemplateRepositoryEntry[], required
    - `path` string, required
    - `name` string, required
    - `version` string, nullable
    - `description` string, nullable

## Other responses

- `403`: Forbidden
- `404`: Repository or ref not found
- `422`: Invalid request
- `503`: GitHub unavailable

## Changes

- **2026-10-15** `4935907204a4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/agent-templates/sources/scan/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) - [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agenta-ai/apis/agenta-api/revisions/ab601a2309da?raw)