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

# get ElevenLabs API key status

> Which ElevenLabs API key the organization saved for importing voices with `useOrganizationKey`. Never returns the key, only its last four characters.



## OpenAPI

````yaml https://api.anam.ai/swagger.json get /v1/voices/elevenlabs-key
openapi: 3.1.0
info:
  title: Anam AI API
  version: '1.0'
servers:
  - url: https://api.anam.ai
    description: Anam API
security:
  - BearerAuth: []
tags:
  - name: Sessions
  - name: Avatar Videos
  - name: Meetings
  - name: Personas
  - name: Avatars
  - name: Voices
  - name: Pronunciation Dictionaries
  - name: LLMs
  - name: Knowledge
  - name: Tools
  - name: Share Links
  - name: Engine
paths:
  /v1/voices/elevenlabs-key:
    get:
      tags:
        - Voices
      summary: Get the organization's ElevenLabs API key status
      description: >-
        Which ElevenLabs API key the organization saved for importing voices
        with `useOrganizationKey`. Never returns the key, only its last four
        characters.
      operationId: getElevenLabsKey
      responses:
        '200':
          description: The key status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElevenLabsKeyStatus'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceImportApiError'
        '403':
          description: API key lacks voice read access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceImportApiError'
components:
  schemas:
    ElevenLabsKeyStatus:
      type: object
      required:
        - enabled
        - saved
        - hint
        - voiceCount
        - lastValidatedAt
        - lastUsedAt
      properties:
        enabled:
          type: boolean
          description: >-
            Always true: every organization can save a key and import voices
            with useOrganizationKey. Kept for existing clients.
        saved:
          type: boolean
          description: Whether a key is saved.
        hint:
          type:
            - string
            - 'null'
          description: The saved key's last four characters.
        voiceCount:
          type: integer
          description: Voices that speak with the key.
        lastValidatedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: When Anam last checked the key with ElevenLabs.
        lastUsedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: When a session last started with the key, recorded at most hourly.
    VoiceImportApiError:
      type: object
      required:
        - code
        - message
        - requestId
        - retryable
      properties:
        code:
          type: string
          description: >-
            Stable machine-readable failure code. `invalid_request`: the body
            failed validation (see `details.issues`).
            `invalid_provider_details`: Anam's own provider configuration is
            missing; contact support (an unsupported provider or model is
            `invalid_request`). `voice_not_accessible`: the provider can't find
            the voice for Anam's account, either a wrong ID or a private voice;
            `message` lists the ways that voice type can reach Anam.
            `provider_rejected`: the provider refused this voice with this
            model; try another model. `voice_bound_elsewhere`: the ElevenLabs
            voice is linked to another organization through its share link, or
            another import is reserving it; imports with `useOrganizationKey`
            aren't affected. `import_in_progress`: another import of the same
            ElevenLabs voice is running; retry. `provider_rate_limited`,
            `provider_unavailable`, `provider_timeout`: provider-side; retry
            when `retryable` is true. `provider_auth_failed`,
            `sample_upload_failed`, `internal_error`: Anam-side; retry later or
            contact support with `requestId`. `organization_key_missing`: no
            ElevenLabs key is saved; save one with PUT
            /v1/voices/elevenlabs-key. `organization_key_rejected`: ElevenLabs
            refused the saved key; save a new one. `invalid_share_link`:
            `shareUrl` isn't a well-formed ElevenLabs share link; a link whose
            voice ElevenLabs can't find, that is no longer shared, or that isn't
            a Professional Voice Clone gets `voice_not_accessible`.
            `invalid_elevenlabs_key`: ElevenLabs didn't accept the key sent to
            PUT /v1/voices/elevenlabs-key. `rate_limited`: too many key checks
            for your organization this hour; retry after an hour.
          enum:
            - invalid_request
            - invalid_provider_details
            - voice_not_accessible
            - provider_rejected
            - voice_bound_elsewhere
            - import_in_progress
            - provider_rate_limited
            - provider_unavailable
            - provider_timeout
            - provider_auth_failed
            - sample_upload_failed
            - request_cancelled
            - internal_error
            - organization_key_missing
            - organization_key_rejected
            - invalid_share_link
            - invalid_elevenlabs_key
            - rate_limited
        message:
          type: string
          description: >-
            What went wrong and what to do about it, written to be shown to a
            person or acted on by an agent.
        requestId:
          type: string
          description: Quote this when contacting Anam support.
        retryable:
          type: boolean
          description: Whether the same request may succeed if repeated later.
        docsUrl:
          type: string
          format: uri
          description: >-
            Documentation that explains the fix. Optional: present on some
            codes, such as `voice_not_accessible` and the `organization_key_*`
            codes.
        details:
          type: object
          additionalProperties: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

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