--- title: Criar uma atribuição de guardrail | RunAPI description: Vincule um guardrail a uma Chave de API padrão ou a um membro de conta. url: https://runapi.ai/pt-BR/docs/api/management/guardrail-assignments/create.md canonical: https://runapi.ai/pt-BR/docs/api/management/guardrail-assignments/create locale: pt-BR --- > Versão HTML: https://runapi.ai/pt-BR/docs/api/management/guardrail-assignments/create > Índice do site para agentes: https://runapi.ai/llms.txt # Criar uma atribuição de guardrail Vincule um guardrail a uma Chave de API padrão ou a um membro de conta. ## Endpoint POST /api/v1/guardrail_assignments URL base: https://runapi.ai Versão da API: v1 Autenticação: Authorization: Bearer YOUR_MANAGEMENT_API_KEY Autorização: Administradores de conta podem atribuir qualquer alvo elegível. Usuários não administradores podem atribuir apenas suas próprias Chaves de API padrão. ## Solicitação Envie valores apenas no local de requisição listado. ### Corpo JSON ```json { "account_user_id": { "description": "ID de prefixo de membro de conta. Este alvo requer um administrador de conta.", "required": false, "type": "string" }, "api_token_id": { "description": "ID de prefixo da Chave de API Standard. Forneça exatamente um ID de destino.", "required": false, "type": "string" }, "guardrail_id": { "description": "ID de prefixo do guardrail.", "required": true, "type": "string" } } ``` ## Resposta de sucesso HTTP 201 - POST /api/v1/guardrail_assignments ```json { "account_user_id": null, "api_token_id": "token_123", "created_at": "2026-07-27T10:00:00.000Z", "guardrail_id": "guardrail_123", "id": "guardrail_assignment_123" } ``` ## Resposta de erro (401) HTTP 401 ### Esquema de resposta ```json { "properties": { "error": { "description": "Mensagem de erro legível por humanos.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemplo de resposta ```json { "error": "Authentication required" } ``` ## Resposta de erro (403) HTTP 403 ### Esquema de resposta ```json { "properties": { "error": { "description": "Mensagem de erro legível por humanos.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemplo de resposta ```json { "error": "Management API key required" } ``` ## Resposta de erro (400) HTTP 400 ### Esquema de resposta ```json { "oneOf": [ { "properties": { "error": { "description": "Mensagem de erro legível por humanos.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false }, { "properties": { "error": { "description": "Resumo de validação legível por humanos.", "type": "string" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Mensagens de validação com chaves por campo de requisição público, com um array de strings legíveis por humanos para cada campo.", "type": "object" } }, "required": [ "error", "errors" ], "type": "object", "unevaluatedProperties": false } ] } ``` ### Exemplo de resposta ```json { "error": "page must be an integer" } ``` ## Resposta de erro (403) HTTP 403 ### Esquema de resposta ```json { "properties": { "error": { "description": "Mensagem de erro legível por humanos.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemplo de resposta ```json { "error": "Forbidden" } ``` ## Resposta de erro (404) HTTP 404 ### Esquema de resposta ```json { "properties": { "error": { "description": "Mensagem de erro legível por humanos.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemplo de resposta ```json { "error": "Resource not found" } ``` ## Resposta de erro (422) HTTP 422 ### Esquema de resposta ```json { "properties": { "error": { "description": "Resumo de validação legível por humanos.", "type": "string" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Mensagens de validação com chaves por campo de requisição público, com um array de strings legíveis por humanos para cada campo.", "type": "object" } }, "required": [ "error", "errors" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemplo de resposta ```json { "error": "Validation failed", "errors": { "base": [ "Validation failed" ] } } ``` ## Exemplo de cURL ### curl ```curl curl -X POST https://runapi.ai/api/v1/guardrail_assignments \ -H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"guardrail_id":"guardrail_123","api_token_id":"token_123"}' ``` ## Referência relacionada - [Atribuições de proteções](https://runapi.ai/pt-BR/docs/api/management/guardrail-assignments.md) - [Objeto Guardrail Assignment](https://runapi.ai/pt-BR/docs/api/management/guardrail-assignments/object.md) --- ## Mais de RunAPI - [Início](https://runapi.ai/pt-BR/.md) - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models) - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Índice do site para agentes](https://runapi.ai/llms.txt) Contato: contact@runapi.ai ## Dados estruturados ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "TechArticle", "headline": "Criar uma atribuição de guardrail", "description": "Vincule um guardrail a uma Chave de API padrão ou a um membro de conta.", "url": "https://runapi.ai/pt-BR/docs/api/management/guardrail-assignments/create", "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/api/management/guardrail-assignments/create" } ] ```