codai Attestations API

Public execution proofs for verified resolves. The UUID is the capability — no authentication.

GitHub OpenAPI

Operations 2

1 of 2 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file

GET /v1/resolve/attestations/{id} Public execution proof for a verified resolve #
GET /v1/resolve/keys Public keys that sign attestations conformant #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/codai-ro:codai-ro-attestations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

codai-ro-attestations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Codai Ro Attestations API
  version: '1'
  description: 'Operations tagged Attestations across 2 of this provider''s published API definitions: codai-ro-resolve-openapi.json, codai-ro-resolve-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://resolve.codai.ro
  description: Production (private beta)
security:
- bearerAuth: []
tags:
- name: Attestations
  description: Public execution proofs for verified resolves. The UUID is the capability — no authentication.
paths:
  /v1/resolve/attestations/{id}:
    get:
      operationId: getResolveAttestation
      tags:
      - Attestations
      summary: Public execution proof for a verified resolve
      description: 'Returns the attestation JSON for a verified resolve: the base commit, the unified diff,

        the repro test (when the agent wrote one), the exact test commands and the test output

        tails before (failing) and after (passing) the patch, plus the runner image digest and

        timestamps. **Unauthenticated by design** — the random UUID is the capability, so share

        the URL only with people who may see the patch. `kind` is always

        `codai.resolve.attestation.v0`.'
      security: []
      parameters:
      - name: id
        in: path
        required: true
        description: Attestation UUID (from `attestation_id` on the job).
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Attestation found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolveAttestation'
        '404':
          $ref: '#/components/responses/ResolveNotFound'
    servers:
    - url: https://resolve.codai.ro
      description: Production (private beta)
  /v1/resolve/keys:
    get:
      operationId: getResolveKeys
      tags:
      - Attestations
      summary: Public keys that sign attestations
      description: 'Returns the public key(s) used to sign attestation envelopes (`signature` on

        `GET /v1/resolve/attestations/{id}`). ECDSA P-256 / SHA-256 over the DSSE v1 PAE of the

        payload; the signature is DER, base64. **Unauthenticated**, CORS-open and cacheable for

        1 hour. Verify with `codaid resolve verify`, `resolve.verifyAttestation` (TypeScript) or

        `resolve.verify_attestation` (Python). `503` when signing is not configured.'
      security: []
      responses:
        '200':
          description: Current verification keys.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolveKeys'
        '503':
          description: Attestation signing is not configured (`attestation signing not configured`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolveError'
    servers:
    - url: https://resolve.codai.ro
      description: Production (private beta)
components:
  schemas:
    ResolveError:
      type: object
      title: Resolve error
      description: 'Flat error envelope used by every Resolve endpoint. Not the gateway `{ error: { code, message } }` shape.'
      required:
      - error
      properties:
        error:
          oneOf:
          - type: string
            description: Human-readable reason.
            examples:
            - invalid or missing API key
            - not found
          - $ref: '#/components/schemas/ResolveValidationDetails'
    ResolveKeys:
      type: object
      title: Verification keys
      required:
      - keys
      properties:
        keys:
          type: array
          items:
            $ref: '#/components/schemas/ResolveKey'
    ResolveKey:
      type: object
      title: Verification key
      required:
      - keyid
      - algorithm
      - payload_type
      - encoding
      - public_key_pem
      properties:
        keyid:
          type: string
          description: Key identifier (the Cloud KMS key version name).
        algorithm:
          type: string
          const: ECDSA_P256_SHA256
        payload_type:
          type: string
          const: application/vnd.codai.resolve.attestation+json;v=1
        encoding:
          type: string
          description: Envelope and signature encoding.
          examples:
          - DSSE v1; signature DER, base64
        public_key_pem:
          type: string
          description: SPKI public key, PEM.
    ResolveAttestation:
      type: object
      title: Attestation
      description: Public execution proof. Everything needed to reproduce the verification locally.
      required:
      - id
      - kind
      - repo_url
      - base_commit
      - patch
      - repro_test
      - test_command
      - regression_command
      - test_output_before
      - test_output_after
      - regression_output
      - runner_image_digest
      - started_at
      - verified_at
      - signature
      properties:
        id:
          type: string
          format: uuid
        kind:
          type: string
          const: codai.resolve.attestation.v0
        repo_url:
          type: string
          format: uri
        base_commit:
          type: string
          description: Commit SHA the patch applies to.
          examples:
          - 3f1e2d4c5b6a798877665544332211aabbccddee
        patch:
          type: string
          description: Unified diff against `base_commit`.
        repro_test:
          oneOf:
          - $ref: '#/components/schemas/ResolveReproTest'
          - type: 'null'
          description: '`null` when the customer supplied `test_command`.'
        test_command:
          type: string
          description: FAIL_TO_PASS command that was executed.
        regression_command:
          type:
          - string
          - 'null'
          description: PASS_TO_PASS (repo suite) command, when one was run.
        test_output_before:
          type: string
          description: Tail of the test output BEFORE the patch (must fail).
        test_output_after:
          type: string
          description: Tail of the test output AFTER the patch (must pass).
        regression_output:
          type:
          - string
          - 'null'
        runner_image_digest:
          type: string
          description: Container image digest of the verification runner (`unknown` when not recorded).
        started_at:
          type: string
          format: date-time
        verified_at:
          type: string
          format: date-time
        signature:
          oneOf:
          - $ref: '#/components/schemas/ResolveAttestationEnvelope'
          - type: 'null'
          description: 'DSSE envelope signing the canonical statement of this attestation (sha256 of the patch,

            repro test, test outputs; commands, commit, runner digest, timestamps). `null` for

            attestations created before signing was enabled (2026-09-27). Verify against

            `GET /v1/resolve/keys`.

            '
    ResolveValidationDetails:
      type: object
      title: Validation details
      description: Zod `flatten()` output returned when the intake body fails schema validation.
      required:
      - formErrors
      - fieldErrors
      properties:
        formErrors:
          type: array
          description: Errors on the whole object, e.g. `one of issue_url or issue_text is required`.
          items:
            type: string
        fieldErrors:
          type: object
          description: Per-field error messages keyed by field name.
          additionalProperties:
            type: array
            items:
              type: string
    ResolveReproTest:
      type: object
      title: Repro test
      description: Repro test written by the agent when you did not supply `test_command`.
      required:
      - path
      - content
      properties:
        path:
          type: string
          description: Path of the test file relative to the repository root.
          examples:
          - tests/test_repro_issue_6000.py
        content:
          type:
          - string
          - 'null'
          description: Full test file content.
    ResolveAttestationEnvelope:
      type: object
      title: Attestation envelope
      description: 'DSSE v1 envelope. `payload` is base64 of the RFC 8785 (JCS) canonical statement JSON

        `{kind: "codai.resolve.attestation.v1", attestation_id, repo_url, base_commit, patch_sha256,

        repro_test: {path, sha256} | null, test_command, regression_command,

        test_output_before_sha256, test_output_after_sha256, regression_output_sha256,

        runner_image_digest, started_at, verified_at}`. Each `sig` is an ECDSA P-256/SHA-256 DER

        signature (base64) over `PAE(payloadType, payload bytes)` =

        `"DSSEv1 " + len(type) + " " + type + " " + len(body) + " " + body`.

        '
      required:
      - payloadType
      - payload
      - signatures
      properties:
        payloadType:
          type: string
          const: application/vnd.codai.resolve.attestation+json;v=1
        payload:
          type: string
          contentEncoding: base64
          description: Base64 of the canonical statement JSON.
        signatures:
          type: array
          minItems: 1
          items:
            type: object
            required:
            - sig
            properties:
              keyid:
                type: string
                description: Identifier of the signing key; matches `keyid` in `GET /v1/resolve/keys`.
              sig:
                type: string
                contentEncoding: base64
                description: DER-encoded ECDSA signature, base64.
  responses:
    ResolveNotFound:
      description: No such job/attestation, or the job belongs to another user.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ResolveError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: codai_…
      description: An existing codai API key. Jobs are scoped to the key's user; all keys of one user share the same limits and free tier.
x-refined-from:
- codai-ro-resolve-openapi.json
- codai-ro-resolve-openapi.yml