Preview — pending review
This reference is generated from the platform API contract and is still under review. Operations, fields, and descriptions can change before publication.
Start a console AI assistant conversation
console AI assistant. Opens a conversation of the CALLER in this project (scope).
The conversation, its history, tool-call audit and proposals belong to the caller only and are
deleted after 30 days (the token ledger the invoice is built from keeps counts, never content).
Opening one sends nothing to the model and costs nothing.
Validation: READ on compute for the scope -> 403 otherwise (compute:read for tokens);
unreachable scope -> 404.
Feature flag: 404 NOT_FOUND on every assistant route while the service is disabled
(PUBLICCLOUD_ASSISTANT_ENABLED).
Async & state: Synchronous; creates the conversation row. Not recorded in the Activity Log
(nothing changes in the project).
Errors: 401; 403; 404; 500.
Idempotency/Concurrency: Not idempotent; each call opens a new conversation.
bearerTokenAuthorizationBearer <token>An API token (pc_live_…) or a service-account key (sak_live_…), created in Identity & Access Management and sent as Authorization: Bearer <token>. Requests are rate limited per credential and per tenant: every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, and a refused request gets 429 RATE_LIMITED with Retry-After.
scopeId*stringOpaque ownership+authorization scope resolving to tenant + subscription + project.
The new conversation.
application/json- response
A console AI assistant conversation.
id*stringexpiresAt*stringWhen the conversation and its history are deleted.
date-timecurl -X POST "https://example.com/scopes/string/assistant/conversations"{ "id": "string", "expiresAt": "2019-08-24T14:15:22Z"}