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

# Get feature permissions

> Retrieve which roles may schedule each activity type. Owner is always permitted. Owner only.



## OpenAPI

````yaml /openapi.json get /v1/account/permissions
openapi: 3.0.3
info:
  title: Doozy Public API
  version: 1.0.0
  description: >-
    The Doozy Public API allows you to programmatically access your
    organization's data.


    ## Authentication


    All API requests require an API key passed in the `x-api-key` header.


    ```

    x-api-key: dzy_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

    ```


    API keys can be generated and managed through the Doozy dashboard. Each key
    is associated with a user account and inherits that user's permissions.


    ## Rate Limiting


    API requests are rate limited. Rate limiting is handled by Cloudflare. If
    you exceed the rate limit, you'll receive a 429 Too Many Requests response.


    ## Pagination


    List endpoints support cursor-based pagination using `limit` and
    `starting_after` query parameters.
  contact:
    name: Doozy Support
    email: support@doozy.live
    url: https://help.doozy.live/api
servers:
  - url: https://api.doozy.live
    description: Production
security:
  - apiKey: []
tags:
  - name: Quizzes
    description: Quiz analytics and reporting endpoints
  - name: Tracks
    description: Track management and analytics endpoints
  - name: Surveys
    description: Survey and poll analytics endpoints
  - name: Introductions
    description: Doozy Roulette and Matchmaking introduction endpoints
  - name: Account
    description: 'Owner-only workspace settings: user provisioning and feature permissions'
paths:
  /v1/account/permissions:
    get:
      tags:
        - Account
      summary: Get feature permissions
      description: >-
        Retrieve which roles may schedule each activity type. Owner is always
        permitted. Owner only.
      responses:
        '200':
          description: The account's feature permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountPermissionsResponse'
        '401':
          description: Authentication required - missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Insufficient permissions - requires owner role
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - apiKey: []
components:
  schemas:
    AccountPermissionsResponse:
      type: object
      properties:
        object:
          type: string
          enum:
            - account_permissions
          example: account_permissions
        activity_scheduling_roles:
          type: object
          properties:
            christmas_countdown:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            daily_icebreaker:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            daily_quiz:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            doozy_roulette:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            doozy_matchmaking:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            celebrations:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            oneOffCelebration:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            survey:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            time_off:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            track:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            custom_quiz:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
            custom_icebreaker:
              type: array
              items:
                type: string
                enum:
                  - owner
                  - manager
                  - member
                description: >-
                  A role permitted to schedule the activity. Owner is always
                  permitted regardless of what's set.
          required:
            - christmas_countdown
            - daily_icebreaker
            - daily_quiz
            - doozy_roulette
            - doozy_matchmaking
            - celebrations
            - oneOffCelebration
            - survey
            - time_off
            - track
            - custom_quiz
            - custom_icebreaker
        available_activities:
          type: array
          items:
            type: string
            enum:
              - christmas_countdown
              - daily_icebreaker
              - daily_quiz
              - doozy_roulette
              - doozy_matchmaking
              - celebrations
              - oneOffCelebration
              - survey
              - time_off
              - track
              - custom_quiz
              - custom_icebreaker
          description: >-
            Activity types whose scheduling roles can be changed. Celebrations,
            one-off celebrations and time off are fixed to owners and managers.
      required:
        - object
        - activity_scheduling_roles
        - available_activities
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - api_error
                - authentication_error
                - invalid_request_error
                - rate_limit_error
              description: The type of error returned
              example: invalid_request_error
            code:
              type: string
              nullable: true
              description: Machine-readable error code for specific error conditions
              example: resource_not_found
            message:
              type: string
              description: Human-readable error message
              example: 'No such quiz: quiz_abc123'
            param:
              type: string
              nullable: true
              description: The parameter related to the error, if applicable
              example: id
            doc_url:
              type: string
              format: uri
              description: URL to documentation about this error
              example: https://docs.doozy.live/api/errors#resource_not_found
          required:
            - type
            - code
            - message
      required:
        - error
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Generate keys in the Doozy dashboard.

````

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