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

# Start guest context

> Feature-flagged metadata pilot. Saves a Spotify track URL in a temporary workspace before signup. Uses an HttpOnly seven-day cookie; only its hash is stored. One URL per guest session and 100 new guest workspaces per day globally. Extracts artist and release metadata only. Does not run paid enrichment, generate a site, or send email. Serve through the same-origin funnel; cross-site cookie integration is not provided. Retry the same URL and cookie to resume dispatch.



## OpenAPI

````yaml api-reference/openapi/context.json POST /api/context/guest
openapi: 3.1.0
info:
  title: Recoup Context Engine
  version: 0.1.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/context/guest:
    post:
      summary: Start guest context extraction
      description: >-
        Feature-flagged metadata pilot. Saves a Spotify track URL in a temporary
        workspace before signup. Uses an HttpOnly seven-day cookie; only its
        hash is stored. One URL per guest session and 100 new guest workspaces
        per day globally. Extracts artist and release metadata only. Does not
        run paid enrichment, generate a site, or send email. Serve through the
        same-origin funnel; cross-site cookie integration is not provided. Retry
        the same URL and cookie to resume dispatch.
      parameters:
        - name: Origin
          in: header
          required: true
          schema:
            type: string
          description: >-
            The configured funnel origin. This is a browser session flow, not a
            public unauthenticated MCP tool.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - action
                - url
              properties:
                action:
                  type: string
                  enum:
                    - start
                url:
                  type: string
                  format: uri
      responses:
        '200':
          description: Saved guest context or claim receipt.
        '202':
          description: >-
            Guest work saved and workflow dispatched. Preserve Set-Cookie for
            status and claim.
        '400':
          description: Invalid request.
        '401':
          description: Guest session or account authentication missing.
        '403':
          description: Origin or workspace access denied.
        '409':
          description: Operation unavailable; retry the same input and session.
        '503':
          description: Guest context is disabled.
      security: []

````