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

# Reword many prompts at once

> Reword up to 100 tracked prompts by id in one atomic operation, keeping each prompt's measurement history. Any item that is missing, not editable, or has invalid text fails the whole batch. Requires a paid plan.



## OpenAPI

````yaml https://api.spreadjam.com/openapi.json put /v1/prompts
openapi: 3.0.0
info:
  title: SpreadJam API
  version: 1.0.0
servers: []
security: []
tags:
  - name: Meta
    description: Identity and metadata about the authenticated key.
  - name: Keywords
    description: Keyword and topic visibility rankings.
  - name: API keys
    description: Manage the workspace's API keys.
  - name: Analytics
    description: AI-visibility analytics for the workspace.
  - name: Brand
    description: The workspace's brand profile and competitors.
  - name: Prompts
    description: Tracked GEO prompts and their cap state.
paths:
  /v1/prompts:
    put:
      tags:
        - Prompts
      summary: Reword many prompts at once
      description: >-
        Reword up to 100 tracked prompts by id in one atomic operation, keeping
        each prompt's measurement history. Any item that is missing, not
        editable, or has invalid text fails the whole batch. Requires a paid
        plan.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkEditPrompts'
      responses:
        '200':
          description: The per-prompt reword results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkEditPromptsResult'
      security:
        - bearerAuth: []
components:
  schemas:
    BulkEditPrompts:
      type: object
      properties:
        prompts:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                minLength: 1
                description: The prompt to reword.
                example: prompt-123
              text:
                type: string
                minLength: 3
                maxLength: 500
                description: The new wording (3 to 500 characters).
            required:
              - id
              - text
          minItems: 1
          maxItems: 100
          description: The prompts to reword, by id (1 to 100).
      required:
        - prompts
    BulkEditPromptsResult:
      type: object
      properties:
        results:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              changed:
                type: boolean
                description: Whether the wording actually changed.
              wordingChange:
                type: string
                enum:
                  - minor
                  - major
                  - none
            required:
              - id
              - changed
              - wordingChange
      required:
        - results
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A workspace API key issued in Settings → Developer, sent as `Bearer
        sk_…`.

````

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