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

# Read one stored model response

> Original text for one model id stored on a completed or partial run. model_id is the id from the response list or from a report field such as analysis.minority_insights[].supporting_model_ids. Slashes in the id belong in this query parameter. The id is not rewritten when the model is later retired. text is at most max_characters, starting at offset. This read does not start research, call a provider, or charge credits.



## OpenAPI

````yaml https://seneca-research.fly.dev/v1/openapi.json get /v1/research/{run_id}/responses/text
openapi: 3.1.0
info:
  title: Seneca Research API
  version: 0.1.0
  description: >-
    Create a research run, poll it, then read the customer report. Original
    model text is a separate read: list /v1/research/{run_id}/responses, read
    one model at /v1/research/{run_id}/responses/text, or download the panel as
    JSONL from /v1/research/{run_id}/responses/export. Send Authorization:
    Bearer seneca_sk_… Narrative quickstart:
    https://seneca.professionalaiagents.com/api.md
servers:
  - url: https://seneca-research.fly.dev
    description: Production
security: []
paths:
  /v1/research/{run_id}/responses/text:
    get:
      tags:
        - public-api
      summary: Read one stored model response
      description: >-
        Original text for one model id stored on a completed or partial run.
        model_id is the id from the response list or from a report field such as
        analysis.minority_insights[].supporting_model_ids. Slashes in the id
        belong in this query parameter. The id is not rewritten when the model
        is later retired. text is at most max_characters, starting at offset.
        This read does not start research, call a provider, or charge credits.
      operationId: get_research_response_text_v1_research__run_id__responses_text_get
      parameters:
        - name: run_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Run Id
        - name: model_id
          in: query
          required: true
          schema:
            type: string
            description: >-
              Stored model id. Example: anthropic/claude-3-haiku. Use the id
              saved on the run, not a later replacement.
            title: Model Id
          description: >-
            Stored model id. Example: anthropic/claude-3-haiku. Use the id saved
            on the run, not a later replacement.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            description: Character offset into the stored response. The default is 0.
            default: 0
            title: Offset
          description: Character offset into the stored response. The default is 0.
        - name: max_characters
          in: query
          required: false
          schema:
            type: integer
            description: >-
              Maximum characters of original text to return. The default is
              8000. The maximum is 32000.
            default: 8000
            title: Max Characters
          description: >-
            Maximum characters of original text to return. The default is 8000.
            The maximum is 32000.
      responses:
        '200':
          description: >-
            One model's metadata and a character window of its stored text. text
            is null when the model finished without stored text.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicModelResponseOut'
        '400':
          description: >-
            invalid_request when model_id is missing or not a stored model id,
            offset is outside 0–1000000, max_characters is outside 1–32000, or
            the run id cannot be read.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
        '401':
          description: >-
            authentication_required when the bearer token is missing or not a
            bearer token. invalid_api_key when the key is unknown, revoked, or
            expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
        '404':
          description: >-
            run_not_found for an unknown or other-workspace run.
            model_response_not_found when this run has no response stored for
            model_id, including a current catalog id that replaced a retired
            model.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
        '409':
          description: >-
            responses_not_ready while the run is queued, running, or
            synthesizing. research_failed when the run finished without a
            completed or partial panel.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
        '429':
          description: >-
            rate_limit_exceeded. Reads are limited to 120 requests per minute
            per key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
        '500':
          description: internal_error. The body does not include a traceback or a secret.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
      security:
        - SenecaApiKey: []
components:
  schemas:
    PublicModelResponseOut:
      properties:
        object:
          type: string
          const: research.model_response
          title: Object
          default: research.model_response
        model_id:
          type: string
          title: Model Id
          description: Model id stored on this run. A retired model keeps this id.
        display_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Display Name
        laboratory:
          anyOf:
            - type: string
            - type: 'null'
          title: Laboratory
        status:
          type: string
          title: Status
        input_tokens:
          anyOf:
            - type: integer
            - type: 'null'
          title: Input Tokens
        output_tokens:
          anyOf:
            - type: integer
            - type: 'null'
          title: Output Tokens
        text:
          anyOf:
            - type: string
            - type: 'null'
          title: Text
          description: >-
            The requested character window of the original response. Null when
            no text is stored.
        text_characters:
          type: integer
          title: Text Characters
          description: Full stored text length in characters.
        offset:
          type: integer
          title: Offset
          description: Character offset of text within the stored response.
        returned_characters:
          type: integer
          title: Returned Characters
        truncated:
          type: boolean
          title: Truncated
          description: >-
            True when characters remain after this window. Raise offset to read
            the rest.
      additionalProperties: false
      type: object
      required:
        - model_id
        - status
        - text_characters
        - offset
        - returned_characters
        - truncated
      title: PublicModelResponseOut
      description: >-
        One stored model response. text is a character window, not the whole
        panel.
    PublicErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/PublicErrorObject'
      additionalProperties: false
      type: object
      required:
        - error
      title: PublicErrorResponse
      description: Error envelope returned by every /v1 failure. Documentation model only.
    PublicErrorObject:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
        details:
          additionalProperties: true
          type: object
          title: Details
      additionalProperties: false
      type: object
      required:
        - code
        - message
      title: PublicErrorObject
  securitySchemes:
    SenecaApiKey:
      type: http
      description: >-
        Workspace API key created while signed in on the Developers page. Send
        Authorization: Bearer seneca_sk_… A Clerk session token is not accepted.
      scheme: bearer

````

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