workspace

Get Resource

Changed on

Gets the metadata of a resource by ID.

get/v1/workspace/resources/{resource_id}

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/workspace/resources/{resource_id}
  • Auth
    none declared

Path parameters

resource_idstring required

The ID of the target resource.

Query parameters

resource_type'voice' | 'voice_collection' | 'pronunciation_dictionary' | 'dubbing' | 'dubbing_project' | 'project' | 'convai_agents' | 'convai_knowledge_base_documents' | 'convai_tools' | 'convai_settings' | 'convai_secrets' | 'workspace_auth_connections' | 'convai_phone_numbers' | 'convai_mcp_servers' | 'convai_api_integration_connections' | 'convai_api_integration_trigger_connections' | 'convai_batch_calls' | 'convai_agent_response_tests' | 'convai_test_suite_invocations' | 'convai_crawl_jobs' | 'convai_crawl_tasks' | 'convai_kb_external_sync_jobs' | 'convai_whatsapp_accounts' | 'convai_agent_versions' | 'convai_agent_branches' | 'convai_agent_versions_deployments' | 'convai_agent_experiments' | 'convai_memory_entries' | 'convai_templates' | 'dashboard' | 'dashboard_configuration' | 'convai_agent_drafts' | 'resource_locators' | 'assets' | 'content_generations' | 'content_templates' | 'content_skills' | 'songs' | 'transcription_tasks' | 'avatars' | 'avatar_video_generations' | 'resource_collection' | 'studio_projects' | 'convai_analysis_items' required

Resource types that can be shared in the workspace. The name always need to match the collection names

Resource type of the target resource.

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

resource_idstring required

The ID of the resource.

resource_namestring nullable required

The name of the resource, if available.

resource_type'voice' | 'voice_collection' | 'pronunciation_dictionary' | 'dubbing' | 'dubbing_project' | 'project' | 'convai_agents' | 'convai_knowledge_base_documents' | 'convai_tools' | 'convai_settings' | 'convai_secrets' | 'workspace_auth_connections' | 'convai_phone_numbers' | 'convai_mcp_servers' | 'convai_api_integration_connections' | 'convai_api_integration_trigger_connections' | 'convai_batch_calls' | 'convai_agent_response_tests' | 'convai_test_suite_invocations' | 'convai_crawl_jobs' | 'convai_crawl_tasks' | 'convai_kb_external_sync_jobs' | 'convai_whatsapp_accounts' | 'convai_agent_versions' | 'convai_agent_branches' | 'convai_agent_versions_deployments' | 'convai_agent_experiments' | 'convai_memory_entries' | 'convai_templates' | 'dashboard' | 'dashboard_configuration' | 'convai_agent_drafts' | 'resource_locators' | 'assets' | 'content_generations' | 'content_templates' | 'content_skills' | 'songs' | 'transcription_tasks' | 'avatars' | 'avatar_video_generations' | 'resource_collection' | 'studio_projects' | 'convai_analysis_items' required

Resource types that can be shared in the workspace. The name always need to match the collection names

creator_user_idstring nullable required

The ID of the user who created the resource.

anonymous_access_level_override'admin' | 'editor' | 'commenter' | 'viewer' nullable required

The access level for anonymous users. If None, the resource is not shared publicly.

role_to_group_idsobject required

A mapping of grant slots to group IDs. Keys are the preset access roles plus workspace custom-role ids ('role_...'). When the resource is shared with a user, the group id is the user's id.

Example response

{
  "anonymous_access_level_override": "viewer",
  "creator_user_id": "5zavrE1kZXv2lFw9BKgEkf0B5Wqo",
  "resource_id": "4ZUqyldxf71HqUbcP2Lc",
  "resource_name": "My Custom Voice",
  "resource_type": "voice",
  "role_to_group_ids": {
    "admin": [
      "5zavrE1kZXv2lFw9BKgEkf0B5Wqo"
    ],
    "editor": [
      "8ruQDGM2R4w1mFbHI5aROCUjIpJZ"
    ],
    "role_01jd7yq2k8f0abcd1234wxyz": [
      "9mQrTx4vNb2wKpLs6ZyE1cHgUdFa"
    ],
    "viewer": []
  },
  "share_options": [
    {
      "id": "i2YYI6huwBmcgYydAXARmQJc3pmX",
      "name": "user@example.com",
      "type": "user"
    },
    {
      "id": "x1AfvYKAmiqxCnbvZeNXHqqthJaC",
      "name": "mygroup",
      "type": "group"
    }
  ]
}

Changes

  • 863ffaf07716Revision changes
    • warning

      added the new dubbing_project enum value to the response property for the response status

    • info

      added the new enum value dubbing_project to the query request parameter resource_type

  • 01782c0621abRevision changes
    • breaking

      removed the enum value convai_coaching_proposals from the query request parameter resource_type

    • info

      removed the convai_coaching_proposals enum value from the response property for the response status