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

# Run a settings or team action

> Holidays: add_holiday needs holiday_date and label, remove_holiday needs holiday_date. Team: invite sends an invitation (email, role, full_name); resend_invite, revoke, suspend, reactivate, make_owner and remove_member act on member_id. Only owners and admins can manage the team, and only an owner can make an owner. Requires write access. This operation can change workspace data or trigger an external side effect; review the request before sending it and do not retry blindly after a timeout.



## OpenAPI

````yaml /openapi.json post /api/v1/public/workspace-settings/actions
openapi: 3.1.0
info:
  description: >-
    Customer-facing API for managing outreach, leads, conversations, voice
    agents, knowledge bases, analytics, and webhooks.
  title: Sendora Public API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.sendora.ai
security: []
tags:
  - description: Leads, lead lists, importing, enriching and finding new prospects.
    name: Leads
  - description: Build, run and measure outreach, and enroll leads.
    name: Campaigns
  - description: Read and send messages, and manage who must not be contacted.
    name: Conversations
  - description: >-
      Voice and chat agents, their tools, knowledge bases, voices and website
      widgets.
    name: Agents
  - description: >-
      Start calls, and manage phone numbers, SMS registration, sending accounts
      and email domains.
    name: Calls and numbers
  - description: Webhooks, jobs, analytics and the Copilot assistant.
    name: Platform
  - description: Manage client workspaces, plans and branding.
    name: Agency
paths:
  /api/v1/public/workspace-settings/actions:
    post:
      tags:
        - Platform
      summary: Run a settings or team action
      description: >-
        Holidays: add_holiday needs holiday_date and label, remove_holiday needs
        holiday_date. Team: invite sends an invitation (email, role, full_name);
        resend_invite, revoke, suspend, reactivate, make_owner and remove_member
        act on member_id. Only owners and admins can manage the team, and only
        an owner can make an owner. Requires write access. This operation can
        change workspace data or trigger an external side effect; review the
        request before sending it and do not retry blindly after a timeout.
      operationId: settings_action_api_v1_public_workspace_settings_actions_post
      parameters:
        - in: header
          name: X-API-Key
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
        - in: header
          name: Authorization
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      requestBody:
        content:
          application/json:
            schema:
              discriminator:
                mapping:
                  add_holiday: '#/components/schemas/SettingsAction'
                  invite: '#/components/schemas/TeamAction'
                  make_owner: '#/components/schemas/TeamAction'
                  reactivate: '#/components/schemas/TeamAction'
                  remove_holiday: '#/components/schemas/SettingsAction'
                  remove_member: '#/components/schemas/TeamAction'
                  resend_invite: '#/components/schemas/TeamAction'
                  revoke: '#/components/schemas/TeamAction'
                  suspend: '#/components/schemas/TeamAction'
                propertyName: action
              oneOf:
                - $ref: '#/components/schemas/SettingsAction'
                - $ref: '#/components/schemas/TeamAction'
              title: Body
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                title: >-
                  Response Settings Action Api V1 Public Workspace Settings
                  Actions Post
                type: object
          description: Successful Response
        '401':
          description: The X-API-Key header is missing, invalid, expired, or revoked.
        '402':
          description: >-
            The workspace is suspended for billing, or the request would exceed
            a plan or usage limit.
        '403':
          description: >-
            The key is valid but lacks the required scope, or the workspace has
            no active plan, lacks the entitlement, or has this feature turned
            off or view-only.
        '410':
          description: The workspace behind this key has been deleted.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
        '500':
          description: >-
            An unexpected Sendora error occurred. Retry only if the operation is
            safe to repeat.
        '503':
          description: >-
            An entitlement or billing check is temporarily unavailable. Retry
            after the Retry-After interval.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - label: cURL
          lang: bash
          source: >-
            curl -X POST
            'https://api.sendora.ai/api/v1/public/workspace-settings/actions' -H
            "X-API-Key: $SENDORA_API_KEY" -H "Content-Type: application/json" \
              -d '{"action":"add_holiday"}'
        - label: Python
          lang: python
          source: >-
            import requests


            url =
            'https://api.sendora.ai/api/v1/public/workspace-settings/actions'

            headers = {'X-API-Key': '$SENDORA_API_KEY'}

            response = requests.post(url, headers=headers, json={'action':
            'add_holiday'})

            response.raise_for_status()

            print(response.json())
        - label: JavaScript
          lang: javascript
          source: >-
            const response = await
            fetch("https://api.sendora.ai/api/v1/public/workspace-settings/actions",
            {
              method: "POST",
              headers: { 'X-API-Key': process.env.SENDORA_API_KEY, 'Content-Type': 'application/json' },
              body: JSON.stringify({"action": "add_holiday"}),
            });

            if (!response.ok) throw new Error(await response.text());

            console.log(await response.json());
        - label: Go
          lang: go
          source: >-
            req, err := http.NewRequest("POST",
            "https://api.sendora.ai/api/v1/public/workspace-settings/actions",
            bytes.NewBufferString(`{"action": "add_holiday"}`))

            if err != nil { log.Fatal(err) }

            req.Header.Set("X-API-Key", os.Getenv("SENDORA_API_KEY"))

            req.Header.Set("Content-Type", "application/json")

            resp, err := http.DefaultClient.Do(req)

            if err != nil { log.Fatal(err) }

            defer resp.Body.Close()
components:
  schemas:
    SettingsAction:
      properties:
        action:
          description: Action returned by the Sendora API.
          enum:
            - add_holiday
            - remove_holiday
          title: Action
          type: string
        holiday_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: The day, YYYY-MM-DD. Sending pauses on holidays
          title: Holiday Date
        label:
          anyOf:
            - maxLength: 120
              type: string
            - type: 'null'
          description: 'add_holiday: what the day is'
          title: Label
      required:
        - action
      title: SettingsAction
      type: object
    TeamAction:
      properties:
        action:
          description: Action returned by the Sendora API.
          enum:
            - invite
            - resend_invite
            - revoke
            - suspend
            - reactivate
            - make_owner
            - remove_member
          title: Action
          type: string
        email:
          anyOf:
            - maxLength: 320
              type: string
            - type: 'null'
          description: 'invite: the person''s email'
          title: Email
        full_name:
          default: ''
          description: 'invite: their name'
          maxLength: 120
          title: Full Name
          type: string
        member_id:
          anyOf:
            - type: string
            - type: 'null'
          description: 'Every other action: the member''s `id` from reading include=team'
          title: Member Id
        role:
          default: manager
          description: 'invite: admin, manager or member'
          title: Role
          type: string
      required:
        - action
      title: TeamAction
      type: object
    HTTPValidationError:
      properties:
        detail:
          description: Detail returned by the Sendora API.
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      required: []
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          description: Loc returned by the Sendora API.
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          description: Msg returned by the Sendora API.
          title: Message
          type: string
        type:
          description: Type returned by the Sendora API.
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: Customer API key created in the Sendora dashboard.
      in: header
      name: X-API-Key
      type: apiKey

````

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