Skip to content
ShibaDocs
Navigation

Create thread (idempotent requestId)

Creates an approval pointer; execution still requires human approval. Org API-key runtime calls return 501 until tenant runtime routing is configured.

POST
/api/v1/threads

Authorization

  • bearerAuth
    HTTP Bearer (API key)
    required
    Authorization: Bearer <token>

Request body JSON

  • requestId
    string
    required
    maxLength: 191
  • projectId
    optional
    string

    Repository URL in self-hosted shiba.

  • repoUrl
    optional
    string
  • message
    optional
    string
  • task
    optional
    string
  • publishPullRequest
    optional
    boolean
  • customAgentId
    optional
    string

    Select an available org-scoped bot profile; effective instructions, route, version and expected outputs freeze into the human approval.

  • expectedDeliverables
    optional
    array of
    string

    Optional approval-frozen workspace output paths, in delivery order. Paths are unique ignoring case; relative, non-hidden ASCII segments only (letters/digits, dot, underscore, hyphen, internal spaces), no empty/dot/parent/absolute segments or leading/trailing spaces. Only md/txt/json/csv. Requested complete UTF-8 nonempty files are capped at 16384 bytes each and 65536 bytes total; JSON must parse. Collection checks do not assess semantic quality.

    maxLength: 240 · minLength: 1 · pattern: ^(?!.* (?:/|$))(?:[A-Za-z0-9][A-Za-z0-9._ -]*/)*[A-Za-z0-9][A-Za-z0-9._ -]*\.(?:[mM][dD]|[tT][xX][tT]|[jJ][sS][oO][nN]|[cC][sS][vV])$

Returns

200

Thread or approval receipt

501

Tenant runtime unavailable for org API keys

Type to search…

↑↓ navigate↵ selectEsc close