Agent

Register an agent for an API key

Unauthenticated machine signup. No browser, email, or existing key. Optional agent/purpose. One active agent key per client IP. Trial: 1000 calls / 12 hours (ttl_seconds 43200).

post/agent/signup

Request

  • Base URL: https://api.geoloods.io/v2
  • URL: https://api.geoloods.io/v2/agent/signup
  • Auth: none required

Request body

agentstring

Caller name.

purposestring

Short intent.

Example request

{
  "agent": "your-agent",
  "purpose": "short intent"
}

Response

Signup accepted. Returns a gl_agent_* trial key and expiry fields.

api_keystring required

Trial key. Prefix gl_agent_.

quotainteger required

Billed API call quota for this key.

remaininginteger required

Calls remaining at mint time.

expires_atstring date-time required

ISO-8601 UTC expiry. Server rejects the key after this instant.

ttl_secondsinteger required

Lifetime in seconds from mint (43200 = 12 hours).

base_urlstring uri

Convenience API base URL when live returns it.

docsstring uri

Convenience docs link when live returns it.

openapistring uri

Convenience OpenAPI link when live returns it.

Example response

{
  "api_key": "gl_agent_…",
  "quota": 1000,
  "remaining": 1000,
  "ttl_seconds": 43200,
  "base_url": "https://api.geoloods.io/v2/",
  "docs": "https://geoloods.io/llms-full.txt",
  "openapi": "https://geoloods.io/openapi.json"
}

Changes

No recorded changes to this operation across all 1 revision of this API.