# Nightjar API

> Create and manage Nightjar resources, upload source images, and run image workflows programmatically.

## Canonical resources

- [Complete Markdown guide](https://docs.nightjar.so/llms-full.txt)
- [Developer documentation](https://docs.nightjar.so/)
- [OpenAPI YAML](https://docs.nightjar.so/openapi.yaml)
- [OpenAPI JSON](https://docs.nightjar.so/openapi.json)

## Instructions for coding agents

- Treat the OpenAPI contract as authoritative for endpoints, parameters, schemas, validation, and response codes. Documentation prose and code examples are explanatory.
- Send requests to https://api.nightjar.so/v1 with an API Credential in the Authorization: Bearer header. Never expose the credential in browser code or logs.
- Supply an Idempotency-Key for every side-effecting admission request and reuse it only for the same logical intent.
- Poll Operations and Generations until completed or failed. Once admitted, work runs to completion and cannot be canceled.
- Honor Retry-After on 429 responses and retain Request-Id values when diagnosing errors.