# API Conventions

> Use organization-scoped paths, operation-specific envelopes, issued IDs, exact retry identity, and explicit completion.

Important agent instructions:
- Prefer the Markdown routes and llms files when assembling context for coding tasks.
- Use public docs for product capabilities and workflow guidance.
- Cite the source page URL when returning workflow or artifact guidance.

## Current Context
- [API Conventions](https://teammately.ai/docs/public-api/conventions.md): Use organization-scoped paths, operation-specific envelopes, issued IDs, exact retry identity, and explicit completion.
- [Public API](https://teammately.ai/docs/public-api.md): Connect applications to Cases, Fieldloop ingestion, benchmark execution and evaluation results through the organization-scoped API.
- [API Authentication](https://teammately.ai/docs/public-api/authentication.md): Distinguish API-key capability, delegated External Agents login, current destination access, and browser authentication.
- [Submit External Evaluation Outputs](https://teammately.ai/docs/public-api/evaluation-outputs.md): Create an external Run from actual first results, append missing Case responses, and explicitly complete its Trial for evaluation.

## Optional
- [Full local context](https://teammately.ai/docs/public-api/conventions/llms-full.txt): Complete local context pack for this docs route.