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

# Get Run IDs

> Returns a fresh run_id (UUID) that you can use to identify or track a workflow execution.



## OpenAPI

````yaml get /get_run_id
openapi: 3.1.0
info:
  title: Playbook API Documentation
  description: >-
    This is the documentation for the Playbook API. You can use this API to use
    our service programmatically, this is done by using your API key. <br/> You
    can view your API key using the 'User' tab on https://beta.playbook3d.com/.
  version: '1.0'
servers: []
security: []
tags: []
paths:
  /get_run_id:
    get:
      tags:
        - run-workflow
      summary: Retrieve a new Run ID
      description: >-
        Returns a fresh run_id (UUID) that you can use to identify or track a
        workflow execution.
      operationId: get_run_id
      parameters:
        - name: x-api-key
          in: header
          description: >-
            Your API key. Required by most endpoints for programmatic access.
            Viewable in 'Profile' tab on the website.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer token for authentication (JWT).
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK. Successfully retrieved a run ID.
          content:
            application/json:
              schema:
                type: object
                properties:
                  run_id:
                    type: string
                    format: uuid
                    description: Newly generated run ID (UUID).
                example:
                  run_id: 3fa85f64-5717-4752-b3fc-2c963f66aga6
        '401':
          description: Unauthorized. Check your API key or token.
        '402':
          description: Payment required. Subscription or plan issue.
        '403':
          description: Forbidden. You lack permission to perform this action.
        '404':
          description: Resource not found.
        '500':
          description: Internal Server Error. Something went wrong on the server.
      x-codeSamples:
        - lang: cURL
          source: |-
            curl -X GET \
              -H 'Authorization: Bearer <YOUR_JWT>' \
              -H 'Accept: application/json' \
              'https://api.playbook3d.com/get_run_id'

````