Projects

Run a hosted generation

Fetches the project's spec URL, generates every configured language, and stores each result in the project's history. Each language counts as one hosted generation. Does not open pull requests. Only URL-sourced projects can be regenerated this way; repository sources regenerate on push.

POST
/projects/{project_id}/generations

Fetches the project's spec URL, generates every configured language, and stores each result in the project's history. Each language counts as one hosted generation. Does not open pull requests. Only URL-sourced projects can be regenerated this way; repository sources regenerate on push.

AuthorizationBearer <token>

API key from the console, ak_....

In: header

Path Parameters

project_id*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/projects/string/generations"
{  "data": [    {      "id": "string",      "object": "generation",      "files_omitted": true,      "files_index": [        {          "path": "string",          "bytes": 0        }      ],      "project_id": "string",      "status": "succeeded",      "trigger": "manual",      "language": "typescript",      "meta": {        "title": "string",        "version": "string",        "spec_format": "openapi",        "oas_version": "string",        "converted": true,        "package_name": "string",        "client_name": "string",        "targets": [          "sdk"        ],        "resource_count": 0,        "operation_count": 0,        "schema_count": 0,        "paginated_operation_count": 0,        "omitted_operation_count": 0,        "pr_url": "string",        "pr_number": 0,        "changelog": "string",        "breaking_count": 0,        "baseline": "destination",        "semver": "success",        "semver_note": "string",        "previous_version": "string",        "file_count": 0,        "total_lines": 0      },      "warnings": [        "string"      ],      "files": [        {          "path": "string",          "content": "string"        }      ],      "error": "string",      "created_at": "2019-08-24T14:15:22Z"    }  ]}