# Fillable developer quickstart specification

**Not a functioning API tutorial.** Replace every bracketed field with your product's verified contract. No endpoint, credential, result, or timing has been tested here. Do not publish this template as runnable code.

## Goal
- Intended reader and task: [one useful task]
- Synthetic input fixture and redistribution rights: [fixture]
- Acceptance criteria: [useful outcome, not only a successful HTTP status]
- Variable AI output: [properties to inspect; no promised exact prose]
- Execution boundary: [mock / isolated sandbox / billable service]

## Prerequisites and costs
- Supported OS and exact tested client/runtime versions: [versions]
- Account, permissions, services, downloads and network needs: [requirements]
- Card/plan requirement and possible charges: [cost boundary]
- Fresh-environment setup: [verified steps]

## Credentials
- Actual credential type and required permissions: [type and scope]
- Creation and revocation instructions: [real documentation links]
- Where it may run: [backend only / local / intentionally public]
- How it is supplied without putting a secret in source: [verified method]
- What must never be pasted into browser code, logs or support tickets: [secrets]

## Request sequence
1. [Verified request using this API's actual method, URL, headers and synthetic input.]
2. [If asynchronous: documented status lookup and completion criteria.]
3. [If needed: retrieval or follow-up that demonstrates the promised task.]

## Output specification
- Expected statuses and schema: [actual contract]
- Fields/properties demonstrating useful success: [criteria]
- Pending and failed states: [distinctions]
- Captured output: [only after a real run; include date, versions and environment]
- Mock output: [label simulation clearly if used]

## Recovery
- Missing/expired credential: [documented non-secret diagnostics]
- Invalid fixture: [safe intentional validation exercise and corrected input]
- Timeout after a write: [status lookup and actual idempotency contract]
- Limits/transient failures: [documented retry behavior and cost consequences]

## Cleanup and next task
- Optional cleanup: [scoped to objects actually created in this exercise; verify before execution]
- Follow-up how-to: [existing real link]
- Reference and cost/production requirements: [existing real links]

## Verification record
- Owner: [name/team]
- Date, product/API/client versions, environment: [record]
- Observed completion/failure and remaining limits: [evidence; otherwise not_run]
- Executable snippets selected for safe automated checking: [bounded list]
