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

# Drift

> Every manifest change, newest first.

The feed an operator reads after an incident, and the reason the changes
are a table rather than a flag on the tool.

Both counts are computed over the whole workspace rather than the page, so
filtering to the description changes narrows what is SHOWN without changing
what is CLAIMED.

**Who may call it:** any role. A workspace API key is refused here: this is an act that belongs to a named person.



## OpenAPI

````yaml /api/openapi.json get /v1/mcp/drift
openapi: 3.1.0
info:
  title: RotaGrant API
  version: 0.1.0
  description: >-
    The HTTP API of a RotaGrant deployment, made from the product's own route
    definitions at the commit named in `x-rotascale-source`. Nothing here is
    written by hand.


    There is no shared endpoint. RotaGrant runs in your environment, and your
    deployment serves its own copy of this description at `/api/docs`. That copy
    is the authority on what your version has and which features are switched
    on; this one is the reference for one commit of the main line. The version
    is 0.1.0: routes and shapes can still change.


    Every route says who may call it. Most need a bearer token from the identity
    provider your deployment uses, held by a person with the role named. The
    routes an SDK calls also accept a workspace API key. A few are open, and say
    why.
servers:
  - url: https://{deployment}
    description: Your own deployment. There is no shared endpoint.
    variables:
      deployment:
        default: rotagrant.internal.example
        description: The host your deployment answers on.
security: []
paths:
  /v1/mcp/drift:
    get:
      tags:
        - MCP servers
      summary: Drift
      description: >-
        Every manifest change, newest first.


        The feed an operator reads after an incident, and the reason the changes

        are a table rather than a flag on the tool.


        Both counts are computed over the whole workspace rather than the page,
        so

        filtering to the description changes narrows what is SHOWN without
        changing

        what is CLAIMED.


        **Who may call it:** any role. A workspace API key is refused here: this
        is an act that belongs to a named person.
      operationId: drift_v1_mcp_drift_get
      parameters:
        - name: kind
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: e.g. description_changed
            title: Kind
          description: e.g. description_changed
        - name: q
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: matches server, tool or kind
            title: Q
          description: matches server, tool or kind
        - name: sort
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: column, '-' prefix for descending
            title: Sort
          description: column, '-' prefix for descending
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            default: 100
            title: Limit
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
            title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DriftPageOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - bearerToken: []
components:
  schemas:
    DriftPageOut:
      properties:
        changes:
          items:
            $ref: '#/components/schemas/ToolDriftOut'
          type: array
          title: Changes
        total:
          type: integer
          title: Total
        injections_total:
          type: integer
          title: Injections Total
        limit:
          type: integer
          title: Limit
        offset:
          type: integer
          title: Offset
        has_more:
          type: boolean
          title: Has More
          default: false
      type: object
      required:
        - changes
        - total
        - injections_total
        - limit
        - offset
      title: DriftPageOut
      description: A page of manifest changes, and the counts that describe the whole set.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ToolDriftOut:
      properties:
        id:
          type: string
          title: Id
        server_id:
          type: string
          title: Server Id
        server_name:
          type: string
          title: Server Name
        tool_name:
          type: string
          title: Tool Name
        kind:
          type: string
          title: Kind
        previous_hash:
          anyOf:
            - type: string
            - type: 'null'
          title: Previous Hash
        current_hash:
          anyOf:
            - type: string
            - type: 'null'
          title: Current Hash
        observed_by_agent_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Observed By Agent Id
        trajectory_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Trajectory Id
        observed_at:
          type: string
          format: date-time
          title: Observed At
        detail:
          additionalProperties: true
          type: object
          title: Detail
      type: object
      required:
        - id
        - server_id
        - server_name
        - tool_name
        - kind
        - previous_hash
        - current_hash
        - observed_by_agent_id
        - trajectory_id
        - observed_at
        - detail
      title: ToolDriftOut
      description: One tool whose description or schema moved on an MCP server.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearerToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        A token from the identity provider your deployment federates with. It
        identifies a person; their roles in the workspace decide what they may
        do.

````

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