All Products
Search

This Product

    AI Coding Assistant Lingma:API Overview

    Document Center

    AI Coding Assistant Lingma:API Overview

    Last Updated:Jun 08, 2026

    The Qoder Cloud Agents CN API provides full management capabilities for cloud-hosted AI Agents, covering Agent creation, environment configuration, session management, event streaming, and more. All endpoints follow REST conventions and use JSON for requests and responses.

    Note The API is currently in Beta. Some functionality may change in future releases.

    Gateway URL

    Environment URL
    Production https://api.qoder.com.cn/api/v1/cloud

    Versioning

    The API is currently at version v1. All endpoints are versioned through the /v1/ URL prefix — no additional version header is required.

    Available APIs

    Resource Description Base path
    Agents Agent CRUD and archival /agents
    Environments Runtime environment configuration /environments
    Sessions Agent session creation and lifecycle /sessions
    Events Session event stream reads and pushes /events
    Files File upload and association /files
    Vaults Secure storage for sensitive credentials /vaults
    Skills Agent skill registration and management /skills
    Memory Stores Persistent memory storage /memory_stores

    Request size limits

    • Maximum request body size: 4 MB
    • Requests exceeding this limit are truncated, causing JSON parsing to fail with 400 invalid_request_error (message: "Request body must be valid JSON.").

    Required headers

    Every API request must include the authentication header; Content-Type is recommended but not mandatory — the server can auto-detect:

    Authorization: Bearer $QODER_PAT
Content-Type: application/json  # recommended but not mandatory, server can auto-detect

    Beta status

    1. The API surface is broadly stable, but signatures may receive minor adjustments in future iterations.
    2. New functionality ships behind new beta identifiers.
    3. Lock the API version and add compatibility handling when running in production.
    4. All current features are available without an additional Beta header.

    Quick connectivity check

    # List Agents under the current account (verifies auth and connectivity)
curl -s https://api.qoder.com.cn/api/v1/cloud/agents?limit=1 \
  -H "Authorization: Bearer $QODER_PAT"

    Successful response:

    {
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

    Rate Limiting

    The API application layer currently has no active rate limiting. The gateway layer has global burst traffic suppression and DDoS protection, which may return 429 or 503 when triggered. Clients should implement exponential backoff retry for 5xx/429 (1s → 2s → 4s, max 3 retries).

    Next steps