> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altss.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Read one capability descriptor

> Public, cacheable, free. An unknown id is 404.



## OpenAPI

````yaml /console-openapi.json get /v1/console/capabilities/{id}
openapi: 3.1.1
info:
  title: Altss Console machine API
  version: '2026-11-21'
  description: >-
    Website presentation of the Altss Console contract. REST and MCP request and
    response shapes follow the deployed Console specification. Website operation
    names, server paths and scoped authorization annotations preserve existing
    documentation links. Read the original at
    https://console.altss.com/openapi.json. Capability discovery is public and
    free. Paid execution requires the approved channel, tenant authorization,
    current data licence, wallet funding and explicit quote acceptance. The
    standard human-approved authorization-code flow is MCP-only. REST uses
    supported service grants or manual credentials. Current discovery does not
    confirm a purchasable A2A operation. Current wallet funding minimums are
    recorded in x-altss-runtime.
  x-altss-source-commit: b1516ec334338a831182c7fa1701438392356774
  x-altss-source-openapi:
    url: https://console.altss.com/openapi.json
    sha256: 1edfc4977ed1dfc44a2d13a8a817d7b7c32b2d16fa985f8b93fe085511af0069
servers:
  - url: https://console.altss.com
security: []
tags:
  - name: Console REST
  - name: Console MCP
  - name: Console authorization
externalDocs:
  url: https://console.altss.com/auth.md
  description: Authoritative Console authorization and human-approval guide
paths:
  /v1/console/capabilities/{id}:
    get:
      tags:
        - Console REST
      summary: Read one capability descriptor
      description: Public, cacheable, free. An unknown id is 404.
      operationId: getCapability
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            examples:
              - company.financial_research
      responses:
        '200':
          description: 'The descriptor. Cache-Control: public, max-age=60.'
          headers:
            ETag:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - schemaVersion
                  - capability
                  - marketplaceUrl
                properties:
                  schemaVersion:
                    type: integer
                  capability:
                    $ref: '#/components/schemas/CapabilityDescriptor'
                  marketplaceUrl:
                    type: string
                    format: uri
                    description: >-
                      Read-only link to the full public marketplace. Console
                      reports executable capabilities separately.
                    const: https://altss.com/console/capabilities
        '304':
          description: Not modified.
        '404':
          $ref: '#/components/responses/Error'
      security: []
components:
  schemas:
    CapabilityDescriptor:
      type: object
      required:
        - id
        - aliases
        - version
        - title
        - description
        - family
        - status
        - inputSchema
        - outputSchema
        - pricing
        - limits
        - scopes
        - protocols
        - idempotency
        - provenance
      additionalProperties: false
      properties:
        id:
          type: string
          description: >-
            The one canonical id. Every quote, run, receipt and A2A task carries
            it.
        workspacePath:
          type: string
          description: >-
            Relative Console workspace path for this capability when its
            customer purchase form is available.
          pattern: >-
            ^/console/playground/new[?]capability=[a-z][a-z0-9_]*[.][a-z][a-z0-9_]*$
        aliases:
          type: array
          items:
            type: string
          description: >-
            Other names accepted on REST, MCP and A2A for this capability
            (resolved to id before any work). Empty unless the capability is
            AVAILABLE.
        version:
          type: integer
        title:
          type: string
        description:
          type: string
        family:
          type: string
          enum:
            - financial
            - company
            - search
            - web
            - people
            - entity
            - research
            - monitoring
            - agents
        status:
          type: string
          enum:
            - AVAILABLE
            - COMING_ONLINE
          description: Only AVAILABLE capabilities can be quoted or run.
        inputSchema:
          type: object
          additionalProperties: true
          description: JSON Schema 2020-12 of the quote and run input.
        outputSchema:
          type: object
          additionalProperties: true
          description: JSON Schema 2020-12 of the delivered result.
        pricing:
          type:
            - object
            - 'null'
          description: Fixed price per accepted execution; null while COMING_ONLINE.
          required:
            - model
            - amountMinor
            - currency
            - priceVersion
            - unit
          properties:
            model:
              const: FIXED_PER_ACCEPTED_EXECUTION
            amountMinor:
              type: integer
            currency:
              const: USD
            priceVersion:
              type: string
            unit:
              const: accepted_execution
        limits:
          type: object
          properties:
            timeoutMs:
              type: integer
            maxResultBytes:
              type: integer
            maxEvidenceItems:
              type: integer
            perKeyPerMinute:
              type: integer
            perKeyPerDay:
              type: integer
        scopes:
          type: array
          items:
            type: string
        protocols:
          type: array
          items:
            type: string
            enum:
              - rest
              - mcp
              - a2a
        idempotency:
          type: object
          properties:
            required:
              const: true
            header:
              const: Idempotency-Key
        provenance:
          type: object
          properties:
            sourceCategory:
              type: string
    Error:
      type: object
      additionalProperties: true
      description: >-
        Read error.code (when error is an object) and the HTTP status. REST
        errors may carry statusCode, message, timestamp and path around error;
        some edge refusals are a flat {"error":"<code>"}.
      properties:
        error:
          oneOf:
            - type: object
              additionalProperties: true
              properties:
                code:
                  type: string
                  examples:
                    - FUNDING_REQUIRED
                message:
                  type: string
                retryable:
                  type: boolean
                chargeState:
                  type: string
                  description: For example none, held, released or unknown.
                details:
                  type: object
                  additionalProperties: true
            - type: string
        statusCode:
          type: integer
        message:
          type: string
        timestamp:
          type: string
        path:
          type: string
  responses:
    Error:
      description: >-
        A refused or failed request. Read error.code and the HTTP status; see
        https://console.altss.com/connect#errors. error.chargeState (when
        present) says whether money moved: none, held, released or unknown.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.