---
title: "Get projects"
method: POST
path: "/v1/get-projects"
---

# Get projects

`POST /v1/get-projects`

Retrieve a list of projects.

## Query parameters

- `api_key` string, required

## Request body

- object
  - `project_name` string — Optional project name to filter the results

## Response `200`

Successful response

- object
  - `status` string — Status of the response
  - `result` object[] — List of projects
    - `id` integer — Project ID
    - `name` string — Project name
    - `is_active` string — Project active status

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

---

[API](https://skmtc.net/agilitywriter/apis/agility-writer-api-beta.md) · [All operations](https://skmtc.net/agilitywriter/apis/agility-writer-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agilitywriter/agility-writer-api-beta/revisions/91fc72cb99f6/schema)