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

# Configure automatic new-run telemetry export to Phoenix Cloud

> Requires an owner session and expectedRevision. API key is encrypted and never returned. Omit it to retain the existing key. Disabling cancels pending exports. Destination changes apply only to newly created runs; no historical backfill.

Requires the integrations:write scope.

An interactive owner session is required; bearer tokens cannot call this operation.



## OpenAPI

````yaml /openapi.yaml put /api/v1/integrations/phoenix
openapi: 3.1.0
info:
  title: Factorize API
  version: 1.0.0
  description: >-
    Versioned Factorize REST API. See the hosted docs for examples and OAuth
    discovery.
  x-dashboard-auth: >-
    Access-token and authorized-client management and trace replay operations
    require an interactive owner session; all other operations accept a suitably
    scoped bearer token or owner session.
servers:
  - url: https://app.factorize.sh
security:
  - bearerAuth: []
paths:
  /api/v1/integrations/phoenix:
    put:
      tags:
        - integrations
      summary: Configure automatic new-run telemetry export to Phoenix Cloud
      description: >-
        Requires an owner session and expectedRevision. API key is encrypted and
        never returned. Omit it to retain the existing key. Disabling cancels
        pending exports. Destination changes apply only to newly created runs;
        no historical backfill.


        Requires the integrations:write scope.


        An interactive owner session is required; bearer tokens cannot call this
        operation.
      operationId: put_api_v1_integrations_phoenix
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                endpoint:
                  type: string
                  maxLength: 2048
                  format: uri
                projectName:
                  type: string
                  minLength: 1
                  maxLength: 128
                apiKey:
                  writeOnly: true
                  type: string
                  minLength: 1
                  maxLength: 8192
                  pattern: ^[^\r\n]+$
                enabled:
                  default: true
                  type: boolean
                expectedRevision:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
              required:
                - endpoint
                - projectName
                - expectedRevision
              additionalProperties: false
      responses:
        '200':
          description: Saved configuration
          content:
            application/json:
              schema:
                type: object
                properties:
                  configured:
                    type: boolean
                  endpoint:
                    type: string
                  projectName:
                    type: string
                  projectId:
                    type:
                      - string
                      - 'null'
                  credentialConfigured:
                    type: boolean
                  enabled:
                    type: boolean
                  revision:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  lastTestAt:
                    type:
                      - string
                      - 'null'
                  lastError:
                    type:
                      - string
                      - 'null'
                required:
                  - configured
                  - endpoint
                  - projectName
                  - projectId
                  - credentialConfigured
                  - enabled
                  - revision
                  - lastTestAt
                  - lastError
                additionalProperties: false
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '409':
          $ref: '#/components/responses/Error409'
        '415':
          $ref: '#/components/responses/Error415'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
        '503':
          $ref: '#/components/responses/Error503'
      security:
        - cookieAuth: []
components:
  responses:
    Error400:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error401:
      description: Invalid or revoked credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error403:
      description: Missing scope or required owner session
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error404:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error409:
      description: Operation conflict
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error415:
      description: Unsupported media type; use application/json
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error429:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error500:
      description: Internal error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error503:
      description: Service unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: OAuth2
    cookieAuth:
      type: apiKey
      in: cookie
      name: factorize_session

````

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