Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos ‘view’; las omitidas usan ‘view’. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.
Nombre visible del rol. Debe ser único en tu organización (sin distinguir mayúsculas de minúsculas) y no coincidir con el nombre de un rol del sistema.
Rol disponible en tu organización: un rol integrado del sistema o un rol personalizado.
Show child attributes
¿Esta página le ayudó?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AthenaHQ","colors":{"primary":"#4f39f6","light":"#7c86ff","dark":"#4f39f6"},"logo":{"light":"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68","dark":"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68"},"favicon":"https://mintcdn.com/athenahq/l-RALGQGlLg9vCM3/favicon.ico?fit=max\u0026auto=format\u0026n=l-RALGQGlLg9vCM3\u0026q=85\u0026s=902f75ca9d61dedcf06910b630c2349b","navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.athenahq.ai/settings/api"}},"footer":{"socials":{"website":"https://athenahq.ai","linkedin":"https://linkedin.com/company/athena-hq"}},"contextual":{"options":["copy","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"getting-started/setup"},{"language":"es","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Soporte"}],"primary":{"type":"button","label":"Panel","href":"https://app.athenahq.ai/settings/api"}},"href":"es/getting-started/setup"},{"language":"fr","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Assistance"}],"primary":{"type":"button","label":"Tableau de bord","href":"https://app.athenahq.ai/settings/api"}},"href":"fr/getting-started/setup"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"athenahq","hasAudioNarration":false,"actualSubdomain":"athenahq","customDomains":["docs.athenahq.ai"],"gitSource":{"type":"github","owner":"ay-ay-ay-ay","repo":"athenahq","deployBranch":"main","contentDirectory":"docs-api","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae952f0f8a6220500f817a6","collectionId":"3f17186c-cde6-4889-93f4-f968047e7890","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae952f0f8a6220500f817a6"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae952f0f8a6220500f817a6","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"en","tag":"API Reference","count":128},{"language":"es","tag":"Referencia de la API","count":128},{"language":"fr","tag":"Référence de l’API","count":128},{"language":"en","tag":"Documentation","count":63},{"language":"es","tag":"Documentación","count":63},{"language":"fr","tag":"Documentation","count":63},{"language":"en","tag":"Page Reference","count":55},{"language":"es","tag":"Referencia de páginas","count":55},{"language":"fr","tag":"Référence des pages","count":55},{"language":"en","tag":"Content \u0026 Knowledge","count":38},{"language":"es","tag":"Contenido y conocimiento","count":38},{"language":"fr","tag":"Contenu et connaissances","count":38},{"language":"en","tag":"Core Resources","count":33},{"language":"es","tag":"Recursos principales","count":33},{"language":"fr","tag":"Ressources principales","count":33},{"language":"en","tag":"Administration","count":32},{"language":"es","tag":"Administración","count":32},{"language":"fr","tag":"Administration","count":32},{"language":"en","tag":"Content Hub","count":19},{"language":"es","tag":"Centro de contenido","count":19},{"language":"fr","tag":"Content Hub","count":19},{"language":"en","tag":"Analytics","count":16},{"language":"es","tag":"Analítica","count":16},{"language":"fr","tag":"Analyses","count":16},{"language":"en","tag":"Knowledge Base","count":15},{"language":"es","tag":"Base de conocimientos","count":15},{"language":"fr","tag":"Base de connaissances","count":15},{"language":"en","tag":"Members","count":12},{"language":"es","tag":"Miembros","count":12},{"language":"fr","tag":"Membres","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"es/api-reference/team-management/create-custom-role","slug":"/es/api-reference/team-management/create-custom-role","pageMetadata":{"title":"Crear rol personalizado","description":"Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos 'view'; las omitidas usan 'view'. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.","openapi":"es/api-reference/openapi.json post /api/v1/roles","href":"/es/api-reference/team-management/create-custom-role"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos ‘view’; las omitidas usan ‘view’. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Crear rol personalizado","description":"Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos 'view'; las omitidas usan 'view'. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.","openapi":"es/api-reference/openapi.json post /api/v1/roles","href":"/es/api-reference/team-management/create-custom-role"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Team Management"],"summary":"Crear rol personalizado","description":"Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos 'view'; las omitidas usan 'view'. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.","operationId":"createRole","security":["a0232d32-3fe4-4c11-b6f1-84fc27c5b908"],"requestBody":"610a897a-7c88-41dd-9b8c-b895bc294e11","responses":{"201":"d9c0efdc-a34f-45f8-b27d-d78cc6aca024","400":"69a22204-ee13-4917-9660-022c73ec9fc1","401":"35de756d-1e2a-492a-8cde-ced108d29932","403":"49b72ea2-97e3-4fcc-a6fe-d4738349819a","409":"d4a5c408-e575-49b8-b856-6213eff7409d","500":"b4c11a14-7e9a-4fda-84f2-2d05e1b85871"},"method":"post","type":"path","servers":["845c2237-3719-44cf-a5df-81a362ba791f"],"path":"/api/v1/roles","baseUrlOptions":["https://api.athenahq.ai"],"title":"Crear rol personalizado","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Cuerpo de la solicitud para crear un rol personalizado","required":["name","permissions"],"properties":{"name":{"type":"string","description":"Nombre visible del rol. Debe ser único en tu organización (sin distinguir mayúsculas de minúsculas) y no coincidir con el nombre de un rol del sistema.","example":"Content Manager","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"permissions":{"type":"object","description":"Niveles de acceso por categoría de un rol. Todas las categorías tienen al menos 'view'; las omitidas al crear o actualizar tienen 'view' por defecto.","properties":{"content":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.content","typeLabel":"enum\u003cstring>"},"prompts":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.prompts","typeLabel":"enum\u003cstring>"},"competitors":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.competitors","typeLabel":"enum\u003cstring>"},"analytics":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.analytics","typeLabel":"enum\u003cstring>"},"integrations":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.integrations","typeLabel":"enum\u003cstring>"},"brand_knowledge":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.brand_knowledge","typeLabel":"enum\u003cstring>"},"team":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.team","typeLabel":"enum\u003cstring>"},"billing":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.billing","typeLabel":"enum\u003cstring>"},"api":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.api","typeLabel":"enum\u003cstring>"},"organization":{"type":"string","enum":["none","view","write"],"uniqueKey":"permissions.organization","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"permissions","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"Content Manager","permissions":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d9c0efdc-a34f-45f8-b27d-d78cc6aca024":{"description":"Rol creado correctamente","content":{"application/json":{"schema":{"type":"object","required":["success","role"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"role":{"type":"object","description":"Rol disponible en tu organización: un rol integrado del sistema o un rol personalizado.","required":["role_id","name","slug","is_system","permissions","created_at"],"properties":{"role_id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Identificador único del rol. Se puede usar como `role_id` en invitaciones y actualizaciones de roles. Los roles integrados usan ID centinela con formato GUID (p. ej., `00000000-0000-0000-0000-000000000001`), no UUID RFC 4122.","isRequired":true,"uniqueKey":"role.role_id","typeLabel":"string"},"name":{"type":"string","description":"Nombre visible del rol","example":"Content Manager","isRequired":true,"uniqueKey":"role.name","typeLabel":"string"},"slug":{"type":"string","description":"Nombre normalizado del rol (p. ej., 'admin', 'content-manager')","example":"content-manager","isRequired":true,"uniqueKey":"role.slug","typeLabel":"string"},"is_system":{"type":"boolean","description":"Indica si es un rol integrado del sistema (Admin, Editor, Viewer, Billing). Los roles del sistema no se pueden editar ni eliminar.","isRequired":true,"uniqueKey":"role.is_system","typeLabel":"boolean"},"permissions":{"type":"object","description":"Niveles de acceso por categoría de un rol. Todas las categorías tienen al menos 'view'; las omitidas al crear o actualizar tienen 'view' por defecto.","properties":{"content":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.content","typeLabel":"enum\u003cstring>"},"prompts":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.prompts","typeLabel":"enum\u003cstring>"},"competitors":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.competitors","typeLabel":"enum\u003cstring>"},"analytics":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.analytics","typeLabel":"enum\u003cstring>"},"integrations":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.integrations","typeLabel":"enum\u003cstring>"},"brand_knowledge":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.brand_knowledge","typeLabel":"enum\u003cstring>"},"team":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.team","typeLabel":"enum\u003cstring>"},"billing":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.billing","typeLabel":"enum\u003cstring>"},"api":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.api","typeLabel":"enum\u003cstring>"},"organization":{"type":"string","enum":["none","view","write"],"uniqueKey":"role.permissions.organization","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"role.permissions","typeLabel":"object"},"created_at":{"type":"string","description":"Cuándo se creó el rol","isRequired":true,"uniqueKey":"role.created_at","typeLabel":"string"}},"isRequired":true,"uniqueKey":"role","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"role":{"role_id":"\u003cstring>","name":"Content Manager","slug":"content-manager","is_system":true,"permissions":{"content":"none","prompts":"none","competitors":"none","analytics":"none","integrations":"none","brand_knowledge":"none","team":"none","billing":"none","api":"none","organization":"none"},"created_at":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"69a22204-ee13-4917-9660-022c73ec9fc1":{"description":"Solicitud incorrecta: nombre de rol o permisos no válidos","content":{"application/json":{"schema":{"type":"object","description":"Objeto de respuesta de error","required":["error"],"properties":{"error":{"type":"string","description":"Mensaje de error que describe qué ha fallado","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"35de756d-1e2a-492a-8cde-ced108d29932":{"description":"Sin autorización: falta la clave de API o no es válida","content":{"application/json":{"schema":{"type":"object","description":"Objeto de respuesta de error","required":["error"],"properties":{"error":{"type":"string","description":"Mensaje de error que describe qué ha fallado","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"49b72ea2-97e3-4fcc-a6fe-d4738349819a":{"description":"Acceso denegado: se requiere una clave de API global o la organización no tiene el plan Enterprise","content":{"application/json":{"schema":{"type":"object","description":"Objeto de respuesta de error","required":["error"],"properties":{"error":{"type":"string","description":"Mensaje de error que describe qué ha fallado","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"not_global":{"title":"not_global","value":{"error":"Forbidden: global API key required"}},"not_enterprise":{"title":"not_enterprise","value":{"error":"Custom roles are available on the Enterprise plan."}}},"exampleType":"examples"}},"exampleType":"examples"},"d4a5c408-e575-49b8-b856-6213eff7409d":{"description":"Conflicto: el nombre del rol ya existe o los permisos coinciden con los de un rol existente","content":{"application/json":{"schema":{"type":"object","description":"Objeto de respuesta de error","required":["error"],"properties":{"error":{"type":"string","description":"Mensaje de error que describe qué ha fallado","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"b4c11a14-7e9a-4fda-84f2-2d05e1b85871":{"description":"Error interno del servidor","content":{"application/json":{"schema":{"type":"object","description":"Objeto de respuesta de error","required":["error"],"properties":{"error":{"type":"string","description":"Mensaje de error que describe qué ha fallado","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a0232d32-3fe4-4c11-b6f1-84fc27c5b908":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Clave de API para autenticarse. Puedes crear una [aquí](https://app.athenahq.ai/organization?tab=api).","scopes":[],"schemeName":"apiKey"}}},"servers":{"845c2237-3719-44cf-a5df-81a362ba791f":{"url":"https://api.athenahq.ai","description":"Servidor de producción"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Clave de API para autenticarse. Puedes crear una [aquí](https://app.athenahq.ai/organization?tab=api).","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","description":"Clave de API para autenticarse. Puedes crear una [aquí](https://app.athenahq.ai/organization?tab=api).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"es/api-reference/openapi.json"},"subdomain":"athenahq","siteName":"AthenaHQ","title":"Crear rol personalizado - AthenaHQ","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/team-management/create-custom-role","matchLevel":1},"es":{"href":"/es/api-reference/team-management/create-custom-role","matchLevel":0},"fr":{"href":"/fr/api-reference/team-management/create-custom-role","matchLevel":1}}},"lastModified":"2026-11-03T03:20:40.346Z","originalFileLocation":"es/api-reference/team-management/create-custom-role.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos \u0026#x27;view\u0026#x27;; las omitidas usan \u0026#x27;view\u0026#x27;. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AthenaHQ\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Crear rol personalizado - AthenaHQ\">\u003cmeta data-mint-head property=\"og:description\" content=\"Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos \u0026#x27;view\u0026#x27;; las omitidas usan \u0026#x27;view\u0026#x27;. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AthenaHQ\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://athenahq.mintlify.app/_mintlify/api/og/v2?division=Roles\u0026amp;title=Crear+rol+personalizado\u0026amp;description=Crea+un+rol+personalizado+con+una+matriz+de+permisos+por+categor%C3%ADa.+Disponible+en+el+plan+Enterprise.+Cada+categor%C3%ADa+tiene+al+menos+%27view%27%3B+las+omitidas+usan+%27v\u0026amp;theme=0b3a918be6754723090d9161\u0026amp;signature=b4a946cd74908b859d8a1fa86def1c854e650719026861d822242429c1c77ab3\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Crear rol personalizado - AthenaHQ\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos \u0026#x27;view\u0026#x27;; las omitidas usan \u0026#x27;view\u0026#x27;. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://athenahq.mintlify.app/_mintlify/api/og/v2?division=Roles\u0026amp;title=Crear+rol+personalizado\u0026amp;description=Crea+un+rol+personalizado+con+una+matriz+de+permisos+por+categor%C3%ADa.+Disponible+en+el+plan+Enterprise.+Cada+categor%C3%ADa+tiene+al+menos+%27view%27%3B+las+omitidas+usan+%27v\u0026amp;theme=0b3a918be6754723090d9161\u0026amp;signature=b4a946cd74908b859d8a1fa86def1c854e650719026861d822242429c1c77ab3\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AthenaHQ\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4f39f6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/api-reference/team-management/create-custom-role.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.athenahq.ai/api-reference/team-management/create-custom-role\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.athenahq.ai/fr/api-reference/team-management/create-custom-role\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.athenahq.ai/api-reference/team-management/create-custom-role\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.athenahq.ai/#organization\",\"name\":\"AthenaHQ\",\"url\":\"https://docs.athenahq.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.athenahq.ai#website\",\"name\":\"AthenaHQ\",\"url\":\"https://docs.athenahq.ai\",\"publisher\":{\"@id\":\"https://docs.athenahq.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role#webpage\",\"url\":\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role\",\"name\":\"Crear rol personalizado\",\"description\":\"Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos 'view'; las omitidas usan 'view'. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.\",\"dateModified\":\"2026-11-03T03:20:40.346Z\",\"isPartOf\":{\"@id\":\"https://docs.athenahq.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Administración\",\"item\":\"https://docs.athenahq.ai/es/api-reference/groups/list-groups\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Roles\",\"item\":\"https://docs.athenahq.ai/es/api-reference/team-management/list-roles\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Crear rol personalizado\",\"item\":\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role#apireference\",\"headline\":\"Crear rol personalizado\",\"name\":\"Crear rol personalizado\",\"description\":\"Crea un rol personalizado con una matriz de permisos por categoría. Disponible en el plan Enterprise. Cada categoría tiene al menos 'view'; las omitidas usan 'view'. El nombre debe ser único en la organización y no coincidir con un rol del sistema. La matriz no debe duplicar otra existente. Requiere una clave de API global.\",\"url\":\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role\",\"mainEntityOfPage\":{\"@id\":\"https://docs.athenahq.ai/es/api-reference/team-management/create-custom-role#webpage\"},\"dateModified\":\"2026-11-03T03:20:40.346Z\",\"publisher\":{\"@id\":\"https://docs.athenahq.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.athenahq.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AthenaHQ\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"AthenaHQ","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/team-management/create-custom-role"}]},{"language":"es","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Soporte"}],"primary":{"type":"button","label":"Panel","href":"https://app.athenahq.ai/settings/api"}},"tabs":[{"tab":"Documentación","icon":"book-open","pages":[{"title":"Documentación","href":"/es/getting-started/setup"}]},{"tab":"Referencia de la API","icon":"code","groups":[{"group":"Descripción general","pages":[{"title":"Introducción","icon":"book","href":"/es/api-reference/introduction"},{"title":"Autenticación","icon":"key","href":"/es/api-reference/authentication"},{"title":"Inicio de sesión único (SSO)","icon":"lock","href":"/es/api-reference/sso"},{"title":"Límites de solicitudes","icon":"gauge","href":"/es/api-reference/rate-limits"},{"title":"Registro de cambios","icon":"clock-rotate-left","href":"/es/api-reference/changelog"}]},{"group":"Integraciones","pages":[{"title":"Servidor MCP","icon":"plug","href":"/es/api-reference/mcp"},{"title":"Looker Studio","icon":"chart-line","href":"/es/api-reference/looker-studio"},{"title":"Power BI y Microsoft Fabric","icon":"chart-column","href":"/es/api-reference/powerbi-fabric"},{"title":"Exportaciones de vistas guardadas","icon":"file-export","href":"/es/api-reference/saved-view-exports"}]},{"group":"Recursos principales","pages":[{"group":"Utilidades","pages":[{"title":"Validar clave de API","openapi":"es/api-reference/openapi.json get /api/validate-api-key","href":"/es/api-reference/basics/validate-api-key"},{"title":"Obtener intervalo de fechas","openapi":"es/api-reference/openapi.json get /api/v1/date-range","href":"/es/api-reference/basics/get-date-range"},{"title":"Consultar datos del informe de Looker Studio","openapi":"es/api-reference/openapi.json post /api/v1/looker-studio/data","href":"/es/api-reference/analytics/query-looker-studio-report-data"}]},{"group":"Sitios web","pages":[{"title":"Obtener sitios web","openapi":"es/api-reference/openapi.json get /api/v1/websites","href":"/es/api-reference/basics/get-websites"},{"title":"Crear sitio web","openapi":"es/api-reference/openapi.json post /api/v1/websites","href":"/es/api-reference/basics/create-website"},{"title":"Configurar sitio web","openapi":"es/api-reference/openapi.json post /api/v1/websites/provision","href":"/es/api-reference/basics/provision-website"},{"title":"Actualizar sitio web","openapi":"es/api-reference/openapi.json patch /api/v1/websites/{website_id}","href":"/es/api-reference/basics/update-website"},{"title":"Eliminar sitio web","openapi":"es/api-reference/openapi.json post /api/v1/websites/{website_id}/delete","href":"/es/api-reference/basics/delete-website"},{"title":"Restaurar sitio web","openapi":"es/api-reference/openapi.json post /api/v1/websites/{website_id}/restore","href":"/es/api-reference/basics/restore-website"}]},{"group":"Consultas","pages":[{"title":"Obtener consultas","openapi":"es/api-reference/openapi.json get /api/v1/prompts","href":"/es/api-reference/basics/get-prompts"},{"title":"Crear consultas","openapi":"es/api-reference/openapi.json post /api/v1/prompts","href":"/es/api-reference/basics/create-prompts"},{"title":"Actualizar consulta","openapi":"es/api-reference/openapi.json patch /api/v1/prompts/{prompt_id}","href":"/es/api-reference/basics/update-prompt"},{"title":"Pausar o reanudar consultas","openapi":"es/api-reference/openapi.json patch /api/v1/prompts/status","href":"/es/api-reference/basics/pause-or-unpause-prompts"},{"title":"Eliminar consulta","openapi":"es/api-reference/openapi.json delete /api/v1/prompts/{prompt_id}","href":"/es/api-reference/basics/delete-prompt"},{"title":"Obtener etiquetas de consultas","openapi":"es/api-reference/openapi.json get /api/v1/prompt-tags","href":"/es/api-reference/basics/get-prompt-tags"},{"title":"Listar programaciones de consultas","openapi":"es/api-reference/openapi.json get /api/v1/prompt-schedules","href":"/es/api-reference/basics/list-prompt-schedules"}]},{"group":"Claves de API","pages":[{"title":"Listar claves de API","openapi":"es/api-reference/openapi.json get /api/v1/api-keys","href":"/es/api-reference/basics/list-api-keys"}]},{"group":"Actividad","pages":[{"title":"Listar actividad","openapi":"es/api-reference/openapi.json get /api/v1/activity","href":"/es/api-reference/basics/list-activity"}]},{"group":"Temas","pages":[{"title":"Obtener temas","openapi":"es/api-reference/openapi.json get /api/v1/topics","href":"/es/api-reference/basics/get-topics"},{"title":"Crear tema","openapi":"es/api-reference/openapi.json post /api/v1/topics","href":"/es/api-reference/basics/create-topic"},{"title":"Actualizar tema","openapi":"es/api-reference/openapi.json patch /api/v1/topics/{topic_id}","href":"/es/api-reference/basics/update-topic"},{"title":"Eliminar tema","openapi":"es/api-reference/openapi.json delete /api/v1/topics/{topic_id}","href":"/es/api-reference/basics/delete-topic"}]},{"group":"Perfiles de audiencia y competidores","pages":[{"title":"Obtener perfiles de audiencia","openapi":"es/api-reference/openapi.json get /api/v1/personas","href":"/es/api-reference/basics/get-personas"},{"title":"Obtener competidores","openapi":"es/api-reference/openapi.json get /api/v1/competitors","href":"/es/api-reference/basics/get-competitors"}]},{"group":"Ubicaciones","pages":[{"title":"Obtener ubicaciones","openapi":"es/api-reference/openapi.json get /api/v1/locations","href":"/es/api-reference/basics/get-locations"},{"title":"Crear ubicación","openapi":"es/api-reference/openapi.json post /api/v1/locations","href":"/es/api-reference/basics/create-location"},{"title":"Actualizar ubicación","openapi":"es/api-reference/openapi.json patch /api/v1/locations/{location_id}","href":"/es/api-reference/basics/update-location"},{"title":"Eliminar ubicación","openapi":"es/api-reference/openapi.json delete /api/v1/locations/{location_id}","href":"/es/api-reference/basics/delete-location"}]},{"group":"Respuestas","pages":[{"title":"Consultar respuestas","openapi":"es/api-reference/openapi.json post /api/v1/responses","href":"/es/api-reference/basics/query-responses"},{"title":"Iniciar obtención de respuestas","openapi":"es/api-reference/openapi.json post /api/v1/response-streaming/start","href":"/es/api-reference/basics/start-response-streaming"},{"title":"Obtener estado de la obtención de respuestas","openapi":"es/api-reference/openapi.json get /api/v1/response-streaming/status","href":"/es/api-reference/basics/get-response-streaming-status"}]},{"group":"Vistas guardadas","pages":[{"title":"Obtener vistas guardadas","openapi":"es/api-reference/openapi.json get /api/v1/saved-views","href":"/es/api-reference/basics/get-saved-views"},{"title":"Obtener vistas guardadas del grupo","openapi":"es/api-reference/openapi.json get /api/v1/group-saved-views","href":"/es/api-reference/basics/get-group-saved-views"}]}]},{"group":"Analítica","pages":[{"group":"Atributos","pages":[{"title":"Listar atributos","openapi":"es/api-reference/openapi.json get /api/v1/attributes","href":"/es/api-reference/attributes/list-attributes"},{"title":"Métricas acumuladas de atributos","openapi":"es/api-reference/openapi.json post /api/v1/attributes/cumulative","href":"/es/api-reference/attributes/cumulative-attribute-metrics"},{"title":"Métricas de atributos de los competidores","openapi":"es/api-reference/openapi.json post /api/v1/attributes/competitors","href":"/es/api-reference/attributes/competitor-attribute-metrics"},{"title":"Serie temporal de atributos","openapi":"es/api-reference/openapi.json post /api/v1/attributes/time-series","href":"/es/api-reference/attributes/attribute-time-series"},{"title":"Observaciones de atributos","openapi":"es/api-reference/openapi.json post /api/v1/attributes/observations","href":"/es/api-reference/attributes/attribute-observations"}]},{"group":"Cuota de voz","pages":[{"title":"Cuota de voz acumulada","openapi":"es/api-reference/openapi.json post /api/v1/metrics/share-of-voice/cumulative","href":"/es/api-reference/metrics/cumulative-share-of-voice"},{"title":"Cuota de voz a lo largo del tiempo","openapi":"es/api-reference/openapi.json post /api/v1/metrics/share-of-voice/time-series","href":"/es/api-reference/metrics/share-of-voice-over-time"}]},{"group":"Porcentaje de menciones","pages":[{"title":"Porcentaje acumulado de menciones","openapi":"es/api-reference/openapi.json post /api/v1/metrics/mention-rate/cumulative","href":"/es/api-reference/metrics/cumulative-mention-rate"},{"title":"Porcentaje de menciones a lo largo del tiempo","openapi":"es/api-reference/openapi.json post /api/v1/metrics/mention-rate/time-series","href":"/es/api-reference/metrics/mention-rate-over-time"}]},{"group":"Porcentaje de citas","pages":[{"title":"Porcentaje acumulado de citas","openapi":"es/api-reference/openapi.json post /api/v1/metrics/citation-rate/cumulative","href":"/es/api-reference/metrics/cumulative-citation-rate"},{"title":"Porcentaje de citas a lo largo del tiempo","openapi":"es/api-reference/openapi.json post /api/v1/metrics/citation-rate/time-series","href":"/es/api-reference/metrics/citation-rate-over-time"}]},{"group":"Posición","pages":[{"title":"Posición acumulada","openapi":"es/api-reference/openapi.json post /api/v1/metrics/position/cumulative","href":"/es/api-reference/metrics/cumulative-position"},{"title":"Posición a lo largo del tiempo","openapi":"es/api-reference/openapi.json post /api/v1/metrics/position/time-series","href":"/es/api-reference/metrics/position-over-time"}]},{"group":"Compras","pages":[{"title":"Métricas de compras","openapi":"es/api-reference/openapi.json post /api/v1/metrics/shopping","href":"/es/api-reference/metrics/shopping-metrics"}]},{"group":"Valor de las búsquedas con IA","pages":[{"title":"Valor de las búsquedas con IA","icon":"money-bill-trend-up","href":"/es/api-reference/ai-search-value"},{"title":"Obtener valor de las búsquedas con IA","openapi":"es/api-reference/openapi.json get /api/v1/ai-search-value","href":"/es/api-reference/ai-search-value/get-ai-search-value"}]}]},{"group":"Contenido y conocimiento","pages":[{"group":"Centro de contenido","pages":[{"title":"Listar hojas del centro de contenido","openapi":"es/api-reference/openapi.json get /api/v1/content/sheets","href":"/es/api-reference/content/list-content-hub-sheets"},{"title":"Listar contenido seguido","openapi":"es/api-reference/openapi.json post /api/v1/content","href":"/es/api-reference/content/list-tracked-content"},{"title":"Listar elementos de contenido","openapi":"es/api-reference/openapi.json get /api/v1/content/items","href":"/es/api-reference/content/list-content-items"},{"title":"Obtener detalle del contenido","openapi":"es/api-reference/openapi.json get /api/v1/content/{content_id}","href":"/es/api-reference/content/get-content-detail"},{"title":"Desglose de citas por consulta y contenido","openapi":"es/api-reference/openapi.json post /api/v1/content/prompts","href":"/es/api-reference/content/per-content-prompt-citation-breakdown"},{"title":"Iniciar proceso de contenido","openapi":"es/api-reference/openapi.json post /api/v1/content/generate","href":"/es/api-reference/content/start-content-pipeline"},{"title":"Obtener estado del proceso de contenido","openapi":"es/api-reference/openapi.json get /api/v1/content/{content_id}/status","href":"/es/api-reference/content/get-content-pipeline-status"},{"title":"Obtener borrador de contenido","openapi":"es/api-reference/openapi.json get /api/v1/content/{content_id}/draft","href":"/es/api-reference/content/get-content-draft"},{"title":"Revisar plan de contenido","openapi":"es/api-reference/openapi.json post /api/v1/content/{content_id}/brief/revise","href":"/es/api-reference/content/revise-content-brief"},{"title":"Aprobar plan de contenido","openapi":"es/api-reference/openapi.json post /api/v1/content/{content_id}/brief/approve","href":"/es/api-reference/content/approve-content-brief"},{"title":"Revisar borrador de contenido","openapi":"es/api-reference/openapi.json post /api/v1/content/{content_id}/revise","href":"/es/api-reference/content/revise-content-draft"},{"title":"Editar borrador de contenido","openapi":"es/api-reference/openapi.json post /api/v1/content/{content_id}/edit","href":"/es/api-reference/content/edit-content-draft"},{"title":"Listar versiones del contenido","openapi":"es/api-reference/openapi.json post /api/v1/content/{content_id}/versions","href":"/es/api-reference/content/list-content-versions"},{"title":"Obtener versión del contenido","openapi":"es/api-reference/openapi.json get /api/v1/content/{content_id}/versions/{version_id}","href":"/es/api-reference/content/get-content-version"},{"title":"Restaurar versión del contenido","openapi":"es/api-reference/openapi.json post /api/v1/content/{content_id}/versions/{version_id}/restore","href":"/es/api-reference/content/restore-content-version"},{"title":"Marcar contenido como publicado","openapi":"es/api-reference/openapi.json post /api/v1/content/{content_id}/publish","href":"/es/api-reference/content/mark-content-as-published"},{"title":"Seguir URLs externas","openapi":"es/api-reference/openapi.json post /api/v1/content/track","href":"/es/api-reference/content/track-external-urls"},{"title":"Cambiar nombre del contenido","openapi":"es/api-reference/openapi.json patch /api/v1/content/{content_id}","href":"/es/api-reference/content/rename-content"},{"title":"Eliminar contenido","openapi":"es/api-reference/openapi.json delete /api/v1/content/{content_id}","href":"/es/api-reference/content/delete-content"}]},{"group":"Recomendaciones de SEO","pages":[{"title":"Enviar recomendaciones de SEO","openapi":"es/api-reference/openapi.json post /api/v1/seo/recommendations","href":"/es/api-reference/seo-recommendations/submit-seo-recommendations"},{"title":"Obtener tarea de recomendaciones de SEO","openapi":"es/api-reference/openapi.json get /api/v1/seo/recommendations/{job_id}","href":"/es/api-reference/seo-recommendations/get-seo-recommendation-job"}]},{"group":"Base de conocimientos","pages":[{"title":"Buscar datos de marca","openapi":"es/api-reference/openapi.json get /api/v1/knowledge-base/facts/search","href":"/es/api-reference/knowledge-base/search-brand-facts"},{"title":"Obtener datos de marca","openapi":"es/api-reference/openapi.json get /api/v1/knowledge-base/facts","href":"/es/api-reference/knowledge-base/get-brand-facts"},{"title":"Obtener pilares","openapi":"es/api-reference/openapi.json get /api/v1/knowledge-base/pillars","href":"/es/api-reference/knowledge-base/get-pillars"},{"title":"Obtener documento del pilar","openapi":"es/api-reference/openapi.json get /api/v1/knowledge-base/pillars/{pillar_id}/document","href":"/es/api-reference/knowledge-base/get-pillar-document"},{"title":"Añadir datos de marca","openapi":"es/api-reference/openapi.json post /api/v1/knowledge-base/facts","href":"/es/api-reference/knowledge-base/add-brand-facts"},{"title":"Actualizar dato de marca","openapi":"es/api-reference/openapi.json patch /api/v1/knowledge-base/facts/{fact_id}","href":"/es/api-reference/knowledge-base/update-brand-fact"},{"title":"Eliminar datos de marca","openapi":"es/api-reference/openapi.json post /api/v1/knowledge-base/facts/delete","href":"/es/api-reference/knowledge-base/delete-brand-facts"},{"title":"Mover datos de marca","openapi":"es/api-reference/openapi.json post /api/v1/knowledge-base/facts/move","href":"/es/api-reference/knowledge-base/move-brand-facts"},{"title":"Crear pilar","openapi":"es/api-reference/openapi.json post /api/v1/knowledge-base/pillars","href":"/es/api-reference/knowledge-base/create-pillar"},{"title":"Actualizar pilar","openapi":"es/api-reference/openapi.json patch /api/v1/knowledge-base/pillars/{pillar_id}","href":"/es/api-reference/knowledge-base/update-pillar"},{"title":"Eliminar pilares","openapi":"es/api-reference/openapi.json post /api/v1/knowledge-base/pillars/delete","href":"/es/api-reference/knowledge-base/delete-pillars"},{"title":"Combinar pilares","openapi":"es/api-reference/openapi.json post /api/v1/knowledge-base/pillars/merge","href":"/es/api-reference/knowledge-base/merge-pillars"}]},{"group":"Espacio de propuestas","pages":[{"title":"Crear un informe de propuesta","openapi":"es/api-reference/openapi.json post /api/v1/pitches","href":"/es/api-reference/pitch-workspace/create-a-pitch-report"},{"title":"Listar propuestas","openapi":"es/api-reference/openapi.json get /api/v1/pitches","href":"/es/api-reference/pitch-workspace/list-pitches"},{"title":"Obtener informe de la propuesta","openapi":"es/api-reference/openapi.json get /api/v1/pitches/{pitch_id}","href":"/es/api-reference/pitch-workspace/get-pitch-report"}]},{"group":"Fuentes","pages":[{"title":"Listar fuentes (por dominio raíz)","openapi":"es/api-reference/openapi.json post /api/v1/sources","href":"/es/api-reference/sources/list-sources-by-root-domain"},{"title":"Listar páginas de fuentes (por URL)","openapi":"es/api-reference/openapi.json post /api/v1/source-pages","href":"/es/api-reference/sources/list-source-pages-per-url"}]}]},{"group":"Administración","pages":[{"group":"Grupos","pages":[{"title":"Listar grupos","openapi":"es/api-reference/openapi.json get /api/v1/groups","href":"/es/api-reference/groups/list-groups"},{"title":"Crear grupo","openapi":"es/api-reference/openapi.json post /api/v1/groups","href":"/es/api-reference/groups/create-group"},{"title":"Obtener grupo","openapi":"es/api-reference/openapi.json get /api/v1/groups/{group_id}","href":"/es/api-reference/groups/get-group"},{"title":"Actualizar grupo","openapi":"es/api-reference/openapi.json patch /api/v1/groups/{group_id}","href":"/es/api-reference/groups/update-group"}]},{"group":"Invitaciones","pages":[{"title":"Crear invitación","openapi":"es/api-reference/openapi.json post /api/v1/invites","href":"/es/api-reference/team-management/create-invite"},{"title":"Invitar de forma masiva a sitios web o grupos","openapi":"es/api-reference/openapi.json post /api/v1/invites/bulk","href":"/es/api-reference/team-management/bulk-invite-to-websites-or-groups"},{"title":"Revocar invitación a la organización","openapi":"es/api-reference/openapi.json delete /api/v1/invites/org/{invite_id}","href":"/es/api-reference/team-management/revoke-organization-invite"},{"title":"Revocar invitación al sitio web","openapi":"es/api-reference/openapi.json delete /api/v1/invites/website/{invite_id}","href":"/es/api-reference/team-management/revoke-website-invite"}]},{"group":"Miembros","pages":[{"title":"Listar miembros de la organización","openapi":"es/api-reference/openapi.json get /api/v1/organizations/members","href":"/es/api-reference/team-management/list-organization-members"},{"title":"Listar miembros del sitio web","openapi":"es/api-reference/openapi.json get /api/v1/websites/{website_id}/members","href":"/es/api-reference/team-management/list-website-members"},{"title":"Listar miembros del grupo","openapi":"es/api-reference/openapi.json get /api/v1/groups/{group_id}/members","href":"/es/api-reference/team-management/list-group-members"},{"title":"Buscar usuario por correo electrónico","openapi":"es/api-reference/openapi.json post /api/v1/users/by-email","href":"/es/api-reference/team-management/look-up-user-by-email"},{"title":"Listar sitios web del usuario","openapi":"es/api-reference/openapi.json get /api/v1/users/{user_id}/websites","href":"/es/api-reference/team-management/list-user-websites"},{"title":"Eliminar usuario de sitios web","openapi":"es/api-reference/openapi.json delete /api/v1/users/{user_id}/websites","href":"/es/api-reference/team-management/remove-user-from-websites"},{"title":"Actualizar rol de un miembro de la organización","openapi":"es/api-reference/openapi.json patch /api/v1/organizations/members/{user_id}","href":"/es/api-reference/team-management/update-organization-member-role"},{"title":"Actualizar rol de un miembro del sitio web","openapi":"es/api-reference/openapi.json patch /api/v1/websites/{website_id}/members/{user_id}","href":"/es/api-reference/team-management/update-website-member-role"},{"title":"Actualizar rol de un miembro del grupo","openapi":"es/api-reference/openapi.json patch /api/v1/groups/{group_id}/members/{user_id}","href":"/es/api-reference/team-management/update-group-member-role"},{"title":"Eliminar acceso de un miembro del grupo","openapi":"es/api-reference/openapi.json delete /api/v1/groups/{group_id}/members/{user_id}","href":"/es/api-reference/team-management/remove-group-member-access"},{"title":"Eliminar miembro de la organización","openapi":"es/api-reference/openapi.json delete /api/v1/organizations/members/{user_id}","href":"/es/api-reference/team-management/remove-organization-member"},{"title":"Eliminar miembro del sitio web","openapi":"es/api-reference/openapi.json delete /api/v1/websites/{website_id}/members/{user_id}","href":"/es/api-reference/team-management/remove-website-member"}]},{"group":"Roles","pages":[{"title":"Listar roles","description":"Devuelve todos los roles de tu organización: los integrados (Admin, Editor, Viewer, Billing) y los personalizados, cada uno con su matriz de permisos resuelta. Usa el `role_id` para asignar un rol mediante invitaciones o actualizaciones de miembros. Requiere una clave de API global.","openapi":"es/api-reference/openapi.json get /api/v1/roles","href":"/es/api-reference/team-management/list-roles"},{"title":"Crear rol personalizado","openapi":"es/api-reference/openapi.json post /api/v1/roles","href":"/es/api-reference/team-management/create-custom-role"},{"title":"Obtener rol","description":"Devuelve un único rol, del sistema o personalizado de tu organización, con su matriz de permisos resuelta. Requiere una clave de API global.","openapi":"es/api-reference/openapi.json get /api/v1/roles/{role_id}","href":"/es/api-reference/team-management/get-role"},{"title":"Actualizar rol personalizado","openapi":"es/api-reference/openapi.json patch /api/v1/roles/{role_id}","href":"/es/api-reference/team-management/update-custom-role"},{"title":"Eliminar rol personalizado","openapi":"es/api-reference/openapi.json delete /api/v1/roles/{role_id}","href":"/es/api-reference/team-management/delete-custom-role"}]},{"group":"Facturación","pages":[{"title":"Obtener créditos del sitio web","openapi":"es/api-reference/openapi.json get /api/v1/credits/website","href":"/es/api-reference/billing/get-website-credits"},{"title":"Obtener créditos de la organización","openapi":"es/api-reference/openapi.json get /api/v1/credits/organization","href":"/es/api-reference/billing/get-organization-credits"},{"title":"Obtener créditos del grupo","openapi":"es/api-reference/openapi.json get /api/v1/credits/group","href":"/es/api-reference/billing/get-group-credits"},{"title":"Obtener suscripción del sitio web","openapi":"es/api-reference/openapi.json get /api/v1/subscriptions/website","href":"/es/api-reference/billing/get-website-subscription"},{"title":"Cancelar suscripción","openapi":"es/api-reference/openapi.json post /api/v1/subscriptions/cancel","href":"/es/api-reference/billing/cancel-subscription"}]},{"group":"Acceso de IA","pages":[{"title":"Acceso de IA","icon":"robot","href":"/es/api-reference/ai-access"},{"title":"Comprobar la accesibilidad para IA de un dominio","openapi":"es/api-reference/openapi.json post /api/v1/ai-access/check","href":"/es/api-reference/ai-access/check-ai-accessibility-for-a-domain"}]}]}]}]},{"language":"fr","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Assistance"}],"primary":{"type":"button","label":"Tableau de bord","href":"https://app.athenahq.ai/settings/api"}},"pages":[{"title":"fr","href":"/fr/api-reference/team-management/create-custom-role"}]}]},"basePath":"","title":"Crear rol personalizado - AthenaHQ","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}