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

# Create an API auth session

> Creates a new browser-based auth session for CLI or other API clients. The returned verification URL should be opened in the user's browser to complete authentication.



## OpenAPI

````yaml /paragraph-api/openapi.json post /v1/api/auth/sessions
openapi: 3.1.0
info:
  title: Paragraph API
  version: 1.0.0
  description: >-
    Public API for interacting with Paragraph publications, posts, users, and
    coined writing.


    ## Rate Limiting

    API requests are rate-limited to ensure fair usage. Contact
    support@paragraph.com for higher limits.


    ## Pagination

    List endpoints support cursor-based pagination using `cursor` and `limit`
    parameters.
  contact:
    name: Paragraph Support
    email: support@paragraph.com
    url: https://paragraph.com/support
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://public.api.paragraph.com/api
    description: Production server
security:
  - {}
tags:
  - name: publications
    description: Operations related to publications
  - name: posts
    description: Operations related to posts and content
  - name: users
    description: Operations related to users and authors
  - name: coins
    description: Operations related to tokenized content
  - name: subscribers
    description: Operations related to subscriber management (requires API key)
paths:
  /v1/api/auth/sessions:
    post:
      tags:
        - auth
      summary: Create an API auth session
      description: >-
        Creates a new browser-based auth session for CLI or other API clients.
        The returned verification URL should be opened in the user's browser to
        complete authentication.
      operationId: createAuthSession
      parameters: []
      requestBody:
        description: Body
        content:
          application/json:
            schema:
              type: object
              properties:
                deviceName:
                  type: string
                  maxLength: 100
                  description: >-
                    Name of the device requesting access (e.g.
                    user@MacBook-Pro.local)
                callbackUrl:
                  type: string
                  format: uri
                  maxLength: 2048
                  description: >-
                    HTTPS callback URL to redirect the user to after approving
                    the session
      responses:
        '201':
          description: Session created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  sessionId:
                    type: string
                    description: Unique session identifier
                  verificationUrl:
                    type: string
                    description: URL to open in the browser to approve the session
                  expiresAt:
                    type: string
                    description: ISO 8601 timestamp when the session expires
                required:
                  - sessionId
                  - verificationUrl
                  - expiresAt
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                    description: Always false for error responses
                  msg:
                    type: string
                    description: Human-readable error message
                required:
                  - success
                  - msg

````