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

# Create Directory Portal Session

> Create a five-minute WorkOS Admin Portal session to connect the org's SCIM directory.

The directory belongs to the same WorkOS organization as the SSO binding and syncs
only while that binding is enabled, so this requires an enabled binding.



## OpenAPI

````yaml https://api.getfloo.com/openapi.json post /v1/organizations/{org_id}/sso/directory/portal-session
openapi: 3.1.0
info:
  title: floo API
  version: 0.1.0
servers:
  - url: https://api.getfloo.com
security: []
paths:
  /v1/organizations/{org_id}/sso/directory/portal-session:
    post:
      tags:
        - enterprise-sso
      summary: Create Directory Portal Session
      description: >-
        Create a five-minute WorkOS Admin Portal session to connect the org's
        SCIM directory.


        The directory belongs to the same WorkOS organization as the SSO binding
        and syncs

        only while that binding is enabled, so this requires an enabled binding.
      operationId: enterprise_sso_create_directory_portal_session
      parameters:
        - name: org_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Org Id
        - $ref: '#/components/parameters/X-Floo-Org-Id'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationSsoPortalSessionResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  parameters:
    X-Floo-Org-Id:
      name: X-Floo-Org-Id
      in: header
      required: false
      schema:
        type: string
        format: uuid
      description: Organization to act in; defaults to the one joined most recently.
  schemas:
    OrganizationSsoPortalSessionResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        url:
          type: string
          title: Url
        expires_in_seconds:
          type: integer
          title: Expires In Seconds
      type: object
      required:
        - id
        - url
        - expires_in_seconds
      title: OrganizationSsoPortalSessionResponse
      description: Short-lived WorkOS Admin Portal URL, returned once and never persisted.
    ErrorResponse:
      properties:
        detail:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - detail
      title: ErrorResponse
      description: Body of every error response except request validation (422).
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
      additionalProperties: true
      type: object
      required:
        - code
        - message
      title: ErrorDetail
      description: Standard error envelope with operation-specific JSON context.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A `floo_` API key.

````

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