Skip to main content
Every request to the Astra API must include a User-Agent header. There is no API key or account signup required — the User-Agent header is the only form of identification Astra needs. This lets the team understand how the API is being used and contact you if something goes wrong with your integration.

​
Required header format

Your User-Agent must follow this pattern: 
{AppName}/{Version} (+{URL})
PartRulesExample
AppNameAlphanumeric characters and hyphens only, case-insensitivemy-app, ValTracker
VersionSemver recommended1.0, 1.2.3
URLOptional — a URL to your app or service info page+https://example.com

​
Examples

curl https://astra.teamfortuna.xyz/v1/agents \
  -H "User-Agent: my-app/1.0.0 (+https://example.com)"
Requests with a missing or empty User-Agent header will receive a 403 Forbidden response. Make sure every request your application sends includes a valid header.

​
Common errors

StatusCauseFix
403 ForbiddenUser-Agent header is missing, empty, or malformedAdd a valid User-Agent header following the {AppName}/{Version} (+{URL}) format
Include your app’s URL in the User-Agent header. This makes it possible for the Astra team to reach out if your requests are causing issues, rather than having your access silently interrupted.