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

# Connect with your own token

> Connect by pasting a token you made at the host yourself.

Works for every host with nothing to set up first, which is why it is
here beside the OAuth flow. The token is checked against the host
before it is stored, and it is only ever used for your own reads.



## OpenAPI

````yaml post /api/code-hosts/{provider}/token
openapi: 3.1.0
info:
  title: Nx1 AI API
  description: |

    AI API for Nx1 Data Platform Management and Automated Data Tasks.

    Authentication is required via PSK in Authorization header.

    Default PSK is | [ask a friend] |
  version: 0.10.2
servers: []
security: []
paths:
  /api/code-hosts/{provider}/token:
    post:
      tags:
        - Code hosts
      summary: Connect with your own token
      description: |-
        Connect by pasting a token you made at the host yourself.

        Works for every host with nothing to set up first, which is why it is
        here beside the OAuth flow. The token is checked against the host
        before it is stored, and it is only ever used for your own reads.
      operationId: connect_with_token_api_code_hosts__provider__token_post
      parameters:
        - name: provider
          in: path
          required: true
          schema:
            type: string
            description: The code host's key.
            title: Provider
          description: The code host's key.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CodeHostTokenRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CodeHostConnection'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Content
      security:
        - OAuth2AuthorizationCodeBearer: []
        - APIKeyHeader: []
components:
  schemas:
    CodeHostTokenRequest:
      properties:
        token:
          type: string
          maxLength: 512
          minLength: 8
          title: Token
        host:
          anyOf:
            - type: string
              maxLength: 256
            - type: 'null'
          title: Host
          description: >-
            The host this token is for, when a tenant has more than one instance
            of a provider. Taken from the repository's remote.
        artifact_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Artifact Id
          description: >-
            The repository this token is for. A repository's own token wins over
            one that covers the whole host; leaving it out connects the host, so
            one token covers every repository on it.
      type: object
      required:
        - token
      title: CodeHostTokenRequest
      description: A token the person made at the host themselves. Write-only.
    CodeHostConnection:
      properties:
        provider:
          type: string
          title: Provider
        label:
          type: string
          title: Label
        host:
          type: string
          title: Host
          default: ''
        for_this_repository:
          type: boolean
          title: For This Repository
          default: false
        connected:
          type: boolean
          title: Connected
        can_sign_in:
          type: boolean
          title: Can Sign In
          default: false
        account:
          type: string
          title: Account
          default: ''
        needs_reconnect:
          type: boolean
          title: Needs Reconnect
          default: false
        connected_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Connected At
      type: object
      required:
        - provider
        - label
        - connected
      title: CodeHostConnection
      description: One person's sign-in at one host, as a page may see it.
    ErrorResponse:
      properties:
        error:
          type: string
          title: Error
          description: A brief description of the error that occurred.
        code:
          type: integer
          title: Code
          description: The HTTP status code associated with the error.
          default: 500
      type: object
      required:
        - error
      title: ErrorResponse
  securitySchemes:
    OAuth2AuthorizationCodeBearer:
      type: oauth2
      flows:
        authorizationCode:
          scopes: {}
          authorizationUrl: >-
            https://sso-rapid.rapid.nx1cloud.com/realms/rapid/protocol/openid-connect/auth
          tokenUrl: >-
            https://sso-rapid.rapid.nx1cloud.com/realms/rapid/protocol/openid-connect/token
    APIKeyHeader:
      type: apiKey
      in: header
      name: Authorization-PSK

````

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