API Reference

Deyta Platform REST API — base URL, authentication, and response format.

The Deyta Gateway API provides programmatic access to Deyta Platform’s memory operations and namespace management. All endpoints are available over HTTPS and return JSON responses.

Base URL

https://api.deyta.ai/gateway/v1

Authentication

All requests require a Bearer token in the Authorization header. You can generate API keys from the Deyta Console.

curl https://api.deyta.ai/gateway/v1/namespaces \
  -H "Authorization: Bearer YOUR_API_KEY"

Response format

Every response follows a consistent envelope:

Success

{
  "success": true,
  "data": { ... }
}

Paginated endpoints include an additional pagination object:

{
  "success": true,
  "data": [ ... ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "total": 45,
    "totalPages": 3
  }
}

Error codes

HTTP Status	Code	Description
400	BAD_REQUEST	Invalid request parameters
401	UNAUTHORIZED	Missing or invalid API key
404	NOT_FOUND	Resource does not exist
409	CONFLICT	Resource already exists (e.g. duplicate namespace name)
500	INTERNAL_SERVER_ERROR	Server-side error

Namespace resolution

Memory operations (/remember, /recall, /forget, /ask) require a target namespace. Provide exactly one of:

• namespace_id — the namespace’s internal ID
• external_reference_id — your own external identifier linked to the namespace

Providing both or neither will return a 400 BAD_REQUEST.