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

# Get an API's schema

> Get agent details + parameter schema. Public endpoint, used by per-agent
docs pages on the marketing site (no API key required).

`{slug:path}` converter accepts slashes so nested slugs like `maps/places`
work (e.g. `/agents/google/maps/places`). The lookup tuple is still
`(group, slug)`; the slug just happens to contain `/`.

The default response is lean (a few sample rows; option lists capped to 25
with `options_total`/`options_truncated` markers). `?expand=full` returns the
complete sample + option lists; `?expand=sample` / `?expand=options` expand
just one. The marketing site fetches `?expand=full`.

A withdrawn id that still has live callers resolves to its replacement (see
`agent_registry.DEPRECATED_ALIASES`) rather than 404ing.



## OpenAPI

````yaml GET /v1/data/{group}/{slug}
openapi: 3.1.0
info:
  title: Mindcase API
  version: '1.0'
  description: Structured web data APIs for AI agents.
servers:
  - url: https://api.mindcase.co
security:
  - bearerAuth: []
paths:
  /v1/data/{group}/{slug}:
    get:
      tags:
        - Developer API
      summary: Get Agent Detail
      description: >-
        Get agent details + parameter schema. Public endpoint, used by per-agent

        docs pages on the marketing site (no API key required).


        `{slug:path}` converter accepts slashes so nested slugs like
        `maps/places`

        work (e.g. `/agents/google/maps/places`). The lookup tuple is still

        `(group, slug)`; the slug just happens to contain `/`.


        The default response is lean (a few sample rows; option lists capped to
        25

        with `options_total`/`options_truncated` markers). `?expand=full`
        returns the

        complete sample + option lists; `?expand=sample` / `?expand=options`
        expand

        just one. The marketing site fetches `?expand=full`.


        A withdrawn id that still has live callers resolves to its replacement
        (see

        `agent_registry.DEPRECATED_ALIASES`) rather than 404ing.
      operationId: get_agent_detail_v1_data__group___slug__get
      parameters:
        - name: group
          in: path
          required: true
          schema:
            type: string
            title: Group
        - name: slug
          in: path
          required: true
          schema:
            type: string
            title: Slug
        - name: expand
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Return the un-truncated payload: `options` for the full enum
              option lists, `sample` for the full sample rows, `full` for both.
              By default option lists are capped at 25 and flagged
              `options_truncated: true`.
            title: Expand
          description: >-
            Return the un-truncated payload: `options` for the full enum option
            lists, `sample` for the full sample rows, `full` for both. By
            default option lists are capped at 25 and flagged
            `options_truncated: true`.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Any error. See `error.code`.
          headers:
            X-Request-ID:
              description: >-
                The id of this call, also in `error.request_id`. Quote it when
                contacting support.
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying, on retryable errors.
              schema:
                type: integer
            RateLimit-Limit:
              description: Requests allowed per minute in this bucket.
              schema:
                type: integer
            RateLimit-Remaining:
              description: Requests left in the window.
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until a slot frees.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorBody'
        detail:
          title: Detail
          description: Legacy field, kept for existing clients. Prefer `error`.
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Errors
          description: >-
            Legacy per-field list on parameter errors. Same as
            `error.details.errors`.
      type: object
      required:
        - error
        - detail
      title: ErrorResponse
      description: >-
        The body of every non-2xx response.


        | Situation | How you see it | `retryable` | Wait |

        |---|---|---|---|

        | Rate limited | HTTP 429 | yes | `retry_after_seconds` |

        | We couldn't read your balance | HTTP 503, or a `failed` job with
        `balance_unavailable` | yes | 5s |

        | Something failed on our side | HTTP 5xx, or a `failed` job | yes | 30s
        |

        | Bad parameters | HTTP 422 | no | Fix them first |

        | Not enough balance | HTTP 402, or `rejected_balance` | no | Add
        balance first |

        | Bad API key | HTTP 401 | no | Fix the key first |

        | Run ended short with rows | `completed` with a `stop_reason` | no |
        Run again on purpose for the rest |


        Retry only when `retryable` is true, after `retry_after_seconds`.
        Without a

        wait, back off exponentially with jitter, up to 30s and about 5
        attempts.

        Send an `Idempotency-Key` so a retry can't charge twice.
    ErrorBody:
      properties:
        code:
          type: string
          title: Code
          description: Stable machine-readable code. Branch on this.
        message:
          type: string
          title: Message
          description: Plain English. May be reworded.
        request_id:
          type: string
          title: Request Id
          description: Quote this when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: Whether the same request, unchanged, can succeed later.
        retry_after_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Retry After Seconds
          description: >-
            When `retryable` is true, how long to wait. Matches the
            `Retry-After` header.
        fault:
          type: string
          enum:
            - input
            - mindcase
          title: Fault
          description: >-
            Whose problem this is: `input` (the request; fix it first) or
            `mindcase` (ours).
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
          description: Extra fields, per code.
      type: object
      required:
        - code
        - message
        - request_id
        - retryable
        - fault
      title: ErrorBody
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your Mindcase API key, mk_live_...

````

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