> ## Documentation Index > Fetch the complete documentation index at: https://docs.protodesk.io/llms.txt > Use this file to discover all available pages before exploring further. # Get run result > Requires ai:use and conversations:read on a connection owned by a current workspace owner/admin. API keys created before human ownership was recorded must be replaced in Settings. OAuth works through MCP; REST uses API keys. Run results are private to the originating connection; another client or a new OAuth grant cannot read them. A missing, redacted, expired, or unfinished result returns 404. Reply suggestion can finish without a draft; inspect reply-guard. ## OpenAPI ````yaml GET /ai/runs/{runId}/results/{kind} openapi: 3.1.0 info: title: Protodesk API version: 0.1.0 description: > The Protodesk Platform API: sync your customers in, attach your own business objects (orders, bookings, listings) to conversations, post and read messages across channels, and receive every workspace event via signed webhooks or a resumable SSE stream. Authenticate every request with a workspace-scoped API key: `Authorization: Bearer pk_...`. Operations that support retry protection document an `Idempotency-Key` header. Reuse it only with an identical request. List pagination is described on each endpoint. Task-oriented guides: [docs.protodesk.io](https://docs.protodesk.io). servers: - url: https://api.protodesk.io/v1 description: Production - url: http://localhost:8080/v1 description: Local development security: [] tags: - name: Evelin description: >- Human-owned AI connections using the existing Evelin runtime. Generation never sends a customer message. - name: Customers description: People or companies contacting a workspace across channels. - name: Conversations description: Customer conversations attached to channels and external business objects. - name: Messages description: Customer, agent, AI, system, and internal messages inside conversations. - name: Attachments description: Scoped file transfer for messages. - name: Channel identities description: >- The same customer across WhatsApp, email, chat, and more — linked identities per channel. - name: Statuses & priorities description: The workspace's conversation statuses and priority levels. - name: Assignments description: >- Who a conversation has been assigned to, over time. Assign via POST /conversations/{conversationId}/assign. - name: Webhooks description: Webhook subscriptions for receiving workspace events. - name: Realtime description: Server-sent event stream of workspace events. - name: API Keys description: Create, list, and revoke workspace API keys. - name: Account description: The workspace and scopes behind your API key. - name: System description: Service metadata and health endpoints. paths: /ai/runs/{runId}/results/{kind}: get: tags: - Evelin summary: Read this connection’s Evelin result description: >- Requires ai:use and conversations:read on a connection owned by a current workspace owner/admin. API keys created before human ownership was recorded must be replaced in Settings. OAuth works through MCP; REST uses API keys. Run results are private to the originating connection; another client or a new OAuth grant cannot read them. A missing, redacted, expired, or unfinished result returns 404. Reply suggestion can finish without a draft; inspect reply-guard. operationId: get_evelin_result parameters: - name: runId in: path required: true schema: type: string - name: kind in: path required: true schema: type: string enum: - reply-draft - follow-up-draft - rewrite - draft-grounding-review - draft-review-translation - reply-guard responses: '200': description: Authorized result. content: application/json: schema: type: object required: - data properties: data: $ref: '#/components/schemas/EvelinResult' default: $ref: '#/components/responses/Error' security: - ApiKeyAuth: [] components: schemas: EvelinResult: type: object description: >- Typed artifact projection for the requested kind. Reply and follow-up drafts expose body; rewrites expose text. Fact reviews expose verdict, claims and evidenceSources. Review translations expose body and reviewLanguage. Reply guard exposes shouldDraft, reasonCode and reason. Results never imply delivery. properties: artifactId: type: string runId: type: string conversationId: type: string sourceMessageId: type: string body: type: string text: type: string changed: type: boolean mode: type: string targetLanguage: type: string outputLanguage: type: string reviewLanguage: type: string sourceLanguage: type: string sourceDraftArtifactId: type: string sourceDraftContentHash: type: string sourceDraftHash: type: string contextArtifactId: type: string strategy: type: string strategyLabel: type: string grounding: $ref: '#/components/schemas/EvelinGrounding' citations: type: array items: type: object claims: type: array items: type: object evidenceSources: type: array items: type: object verdict: type: string shouldDraft: type: boolean reasonCode: type: string reason: type: string overrideApplied: type: boolean knowledgeOutdated: type: boolean createdAt: type: string format: date-time expiresAt: type: - string - 'null' format: date-time EvelinGrounding: type: object required: - state - reason - confidence properties: state: type: string enum: - grounded - weak - no-match reason: type: string confidence: type: number ErrorEnvelope: type: object required: - error properties: error: $ref: '#/components/schemas/Error' Error: type: object required: - code - message - requestId properties: code: type: string example: route.not_found message: type: string example: Not found requestId: type: string example: req_x6q5vl75f5d53m7oet2k4r5w6a responses: Error: description: >- Error response. All /v1 responses carry RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers. A 429 (rate_limit.exceeded) additionally carries Retry-After. Request bodies exceeding the route-class limit (1KB reads, 64KB writes) return 413 (request.body_too_large). headers: X-Request-Id: $ref: '#/components/headers/RequestId' RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' headers: RequestId: description: Request id for tracing this request in logs and support. schema: type: string example: req_x6q5vl75f5d53m7oet2k4r5w6a RateLimitLimit: description: >- Request budget for the route class (read or write) applied to this request. schema: type: integer example: 40 RateLimitRemaining: description: Requests remaining in the current budget after this request. schema: type: integer example: 39 RateLimitReset: description: Seconds until the budget refills to its full limit. schema: type: integer example: 1 RetryAfter: description: Seconds to wait before retrying, sent with 429 responses. schema: type: integer example: 1 securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: Protodesk API key description: > Use a workspace API key in the Authorization header: Bearer pk_.... Older pk_live_ and pk_test_ keys remain valid; their prefixes do not isolate data or select a separate environment. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.