API reference
Generate
Generated HTTP reference for the 1 operation the published OpenAPI document describes under generate.
1 min read
Generate
This page is generated from the published OpenAPI document. It is complete with respect to that document and says nothing about surfaces the document does not describe yet. See what is generated here for what that means.
Base URL: https://api.codespar.dev
Every operation below requires a Bearer token. See Authentication.
GET /v1/generate/servers
List the project's generated servers
Responses
| Status | Body | Description |
|---|---|---|
200 | object | OK |
400 | object | Bad Request: the credential resolves to no project. |
Response 200
| Field | Type | Required | Description |
|---|---|---|---|
servers | array of object | yes | — |
Example response
{
"servers": [
{
"id": "obj_0000000000000000",
"name": "Example",
"version": "string",
"description": "string",
"status": "draft",
"tool_count": 1,
"created_at": "2026-01-15T12:00:00.000Z",
"updated_at": "2026-01-15T12:00:00.000Z"
}
]
}Example request
curl -X GET https://api.codespar.dev/v1/generate/servers \
-H "Authorization: Bearer $CODESPAR_API_KEY"