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

# Create Organization Join Link

> Mint the org's standing self-signup link — the console face of the admin's generate action.

Conflicts instead of replacing a live link: overwriting would strand every copy already handed
out, so the admin has to revoke first and mean it.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json post /api/partners/v2.0/org/{org_id}/join-link
openapi: 3.1.0
info:
  title: Podero Partner API
  version: '2.0'
  description: >-
    This API provides a unified interaction point for Podero's partner
    companies.


    The goal of this API is to give partners easily integratable endpoints that
    don't require extensive software

    development. For this reason, the endpoints focus around user and device
    management, setting of preferences

    and high level device controls.


    While direct control of devices is implemented for special use cases such as
    pause power, we abstract away low level

    direct device steering so developers and partners can focus on delivering
    maximum value to end users.
  termsOfService: https://www.podero.com/terms-and-conditions
servers: []
security: []
paths:
  /api/partners/v2.0/org/{org_id}/join-link:
    post:
      tags:
        - Organization
      summary: Create Organization Join Link
      description: >-
        Mint the org's standing self-signup link — the console face of the
        admin's generate action.


        Conflicts instead of replacing a live link: overwriting would strand
        every copy already handed

        out, so the admin has to revoke first and mean it.
      operationId: >-
        integrations_api_api_v2_organizations_router_create_organization_join_link
      parameters:
        - in: path
          name: org_id
          schema:
            description: The organization ID of the user's organization
            format: uuid
            title: Org Id
            type: string
          required: true
          description: The organization ID of the user's organization
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationOutput'
      security:
        - OAuth2: []
components:
  schemas:
    OrganizationOutput:
      description: >-
        Partner-facing wire contract for an organization.


        Defined independently of the domain read model and the ORM model so the
        API

        shape is owned here; the fields it exposes need not match either of
        them.
      properties:
        id:
          format: uuid
          title: Id
          type: string
        name:
          title: Name
          type: string
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        contact:
          anyOf:
            - type: string
            - type: 'null'
          title: Contact
        default_currency:
          title: Default Currency
          type: string
        country:
          title: Country
          type: string
        trading_enabled:
          title: Trading Enabled
          type: boolean
        reauthorization_link_timeout_days:
          title: Reauthorization Link Timeout Days
          type: integer
        support_enabled:
          title: Support Enabled
          type: boolean
        analytics_enabled:
          title: Analytics Enabled
          type: boolean
        invitations_enabled:
          title: Invitations Enabled
          type: boolean
        trading_view_enabled:
          title: Trading View Enabled
          type: boolean
        onboarding_enabled:
          title: Onboarding Enabled
          type: boolean
        experimental_enabled:
          title: Experimental Enabled
          type: boolean
        lila_enabled:
          title: Lila Enabled
          type: boolean
        join_link:
          anyOf:
            - type: string
            - type: 'null'
          title: Join Link
        is_simulated:
          default: false
          title: Is Simulated
          type: boolean
        access_mode:
          default: full
          enum:
            - full
            - read_only
          title: Access Mode
          type: string
      required:
        - id
        - name
        - default_currency
        - country
        - trading_enabled
        - reauthorization_link_timeout_days
        - support_enabled
        - analytics_enabled
        - invitations_enabled
        - trading_view_enabled
        - onboarding_enabled
        - experimental_enabled
        - lila_enabled
      title: OrganizationOutput
      type: object
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}
        clientCredentials:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}

````