> ## Documentation Index > Fetch the complete documentation index at: https://docs.postclean.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Ativar repurpose > Liga um repurpose em rascunho ou desativado. Só os vídeos postados a partir de agora são republicados. É preciso ter uma conta de origem conectada (`422` em `source_social_account_id`) e pelo menos um destino que ainda esteja no workspace (`422` em `destinations`); os destinos cuja conta foi removida são ignorados. Cada destino utilizável precisa das configurações que a rede exige para publicar (`422` em `destinations`). Em qualquer outro status, a requisição retorna `422` em `status`. ## OpenAPI ````yaml /openapi.json post /repurposes/{repurpose}/activate openapi: 3.1.0 info: title: PostClean API version: 2.0.0 description: >- API REST do PostClean. Autentique com uma chave de API do workspace, enviada como token Bearer no cabeçalho `Authorization`. servers: - url: https://post.chatclean.com.br/api description: PostClean security: - bearerAuth: [] tags: - name: Posts description: Criar, ler, atualizar, excluir e pré-visualizar posts. - name: Post notes description: Notas internas de um post, visíveis aos membros do workspace. - name: Approvals description: Aprovar ou rejeitar posts que aguardam aprovação. - name: Recurrence description: Fazer um post se repetir numa frequência. - name: Media and uploads description: Enviar arquivos e anexar mídia aos posts. - name: Social accounts description: Contas sociais conectadas e as opções de cada rede. - name: Channels description: Horários de postagem e fila de um canal. - name: Ideas description: Ideias do quadro Criar. - name: Idea stages description: As colunas (etapas) do quadro de ideias. - name: Analytics description: Métricas do workspace e dos canais. - name: Labels description: Etiquetas para organizar posts e ideias. - name: Signatures description: Textos reutilizáveis para adicionar aos posts. - name: Workspace description: O workspace ao qual a chave de API pertence. - name: API keys description: Chaves de API pessoais deste workspace. - name: Webhooks description: Webhooks de saída e os registros de entrega. - name: Repurposes description: Automações que republicam vídeos postados fora do PostClean. - name: Platform description: Recursos de cada plataforma e tipos de conteúdo. paths: /repurposes/{repurpose}/activate: parameters: - $ref: '#/components/parameters/RepurposeId' post: tags: - Repurposes summary: Ativar repurpose description: >- Liga um repurpose em rascunho ou desativado. Só os vídeos postados a partir de agora são republicados. É preciso ter uma conta de origem conectada (`422` em `source_social_account_id`) e pelo menos um destino que ainda esteja no workspace (`422` em `destinations`); os destinos cuja conta foi removida são ignorados. Cada destino utilizável precisa das configurações que a rede exige para publicar (`422` em `destinations`). Em qualquer outro status, a requisição retorna `422` em `status`. operationId: activateRepurpose responses: '200': description: O repurpose ativo. content: application/json: schema: $ref: '#/components/schemas/Repurpose' example: id: 9a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d source_social_account_id: 9c8b7a69-4c5d-4e6f-8a0b-2c3d4e5f6071 source_format: reel publish_mode: publish destinations: - social_account_id: 9c8b7a67-2a3b-4c5d-8e9f-0a1b2c3d4e5f content_type: tiktok_video meta: privacy_level: PUBLIC_TO_EVERYONE - social_account_id: 9c8b7a6a-5d6e-4f70-9b1c-3d4e5f607182 content_type: youtube_short status: active paused_reason: null activated_at: '2026-10-08T15:15:00+00:00' last_polled_at: null next_poll_at: null last_error: null created_at: '2026-09-30T18:00:00+00:00' updated_at: '2026-10-08T15:15:00+00:00' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/ValidationError' '429': $ref: '#/components/responses/TooManyRequests' components: parameters: RepurposeId: name: repurpose in: path required: true description: Id do repurpose. Um repurpose de outro workspace devolve `404`. schema: type: string format: uuid example: 9a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d schemas: Repurpose: type: object properties: id: type: string format: uuid source_social_account_id: type: - string - 'null' format: uuid description: >- Conta do Instagram ou do Facebook acompanhada em busca de vídeos novos. `null` quando essa conta foi removida. source_account: oneOf: - $ref: '#/components/schemas/SocialAccount' - type: 'null' description: >- A conta de origem, ou `null` quando ela foi removida. Vem em `GET /repurposes` (e no `PUT` de um repurpose ativo). source_format: type: string enum: - reel - video - story publish_mode: type: string enum: - publish - draft description: >- `publish` publica cada vídeo novo nos destinos; `draft` salva como rascunho. destinations: type: array items: $ref: '#/components/schemas/RepurposeDestination' status: type: string enum: - draft - active - paused - disabled paused_reason: type: - string - 'null' enum: - source_removed - source_unavailable - no_destinations - null description: >- Por que o PostClean pausou. `null` quando não está pausado ou quando a pausa foi sua. activated_at: type: - string - 'null' format: date-time description: >- ISO 8601, em UTC. Só os vídeos postados depois desse instante são republicados. examples: - '2026-10-01T09:00:00+00:00' last_polled_at: type: - string - 'null' format: date-time description: ISO 8601, em UTC. examples: - '2026-10-08T13:45:00+00:00' next_poll_at: type: - string - 'null' format: date-time description: ISO 8601, em UTC. examples: - '2026-10-08T14:00:00+00:00' last_error: type: - string - 'null' published_items_count: type: integer description: >- Itens com status `published`. Itens salvos como rascunho (`drafted`) não entram na conta. Só vem em `GET /repurposes`. created_at: type: string format: date-time description: ISO 8601, em UTC. examples: - '2026-09-30T18:00:00+00:00' updated_at: type: string format: date-time description: ISO 8601, em UTC. examples: - '2026-10-08T13:45:00+00:00' SocialAccount: type: object properties: id: type: string format: uuid platform: $ref: '#/components/schemas/Platform' display_name: type: - string - 'null' description: Nome exibido da conta. username: type: - string - 'null' description: Nome de usuário na rede. status: type: string enum: - connected - disconnected - token_expired description: >- Status da conexão. `token_expired` e `disconnected` pedem reconexão no app. has_posting_schedule: type: boolean description: >- Se o canal tem horários de postagem. Colocar um post na fila (`queue`) exige horários. timezone: type: string description: >- Fuso horário IANA do canal. Os horários da fila e a recorrência seguem esse fuso. posting_goal: type: - integer - 'null' description: Meta de posts por semana do canal. max_content_length: type: integer description: >- Limite de texto desta conta, em caracteres. Uma conta do X com posts longos tem 25000. long_posts: type: boolean description: Se esta conta do X pode publicar posts longos. verified_badge: type: - string - 'null' enum: - blue - business - government - null description: >- Selo de verificação do X; `null` em outras redes ou em contas sem verificação. O selo sozinho não garante posts longos: veja `long_posts`. RepurposeDestination: type: object required: - social_account_id - content_type properties: social_account_id: type: string format: uuid description: >- Conta social do workspace. O Google Business é recusado (os posts dele não aceitam vídeo), assim como a própria conta de origem. content_type: allOf: - $ref: '#/components/schemas/ContentType' description: >- Formato de publicação. Precisa ser da rede da conta e aceitar vídeo (por exemplo `instagram_reel`, `tiktok_video`, `youtube_short`, `x_post`). meta: allOf: - $ref: '#/components/schemas/PlatformMeta' description: >- Configurações da rede, com as mesmas regras do `meta` de um post (mídia de resposta de thread por `url` é recusada). Num repurpose ativo, as configurações que a rede exige para publicar são obrigatórias, como num post agendado (por exemplo `privacy_level` do TikTok, `board_id` do Pinterest, `channel_id` do Discord e uma `description` válida no YouTube). ErrorBody: type: object properties: message: type: string description: Corpo de erro com uma mensagem. ValidationErrorBody: type: object properties: message: type: string errors: type: object additionalProperties: type: array items: type: string description: Corpo de erro de validação. `errors` traz as mensagens por campo. RateLimitErrorBody: type: object properties: name: type: string const: rate_limit_exceeded message: type: string examples: - Rate limit exceeded. Please retry after 30 seconds. description: Corpo devolvido quando o limite de requisições é excedido. Platform: type: string enum: - linkedin - linkedin-page - x - tiktok - youtube - facebook - instagram - instagram-facebook - threads - pinterest - bluesky - mastodon - telegram - discord - google_business description: >- Rede de uma conta social. `linkedin-page` é uma página de empresa no LinkedIn, e `instagram-facebook` é uma conta do Instagram conectada por uma Página do Facebook. ContentType: type: string enum: - instagram_feed - instagram_reel - instagram_story - linkedin_post - linkedin_page_post - facebook_post - facebook_reel - facebook_story - tiktok_video - tiktok_photo - youtube_short - x_post - threads_post - threads_ghost_post - pinterest_pin - pinterest_video_pin - pinterest_carousel - bluesky_post - mastodon_post - telegram_post - discord_message - google_business_post description: >- Formato do post numa rede. Precisa pertencer à rede do destino. `GET /content-types` lista os formatos de cada rede com as regras de mídia. Stories do Instagram e do Facebook não publicam texto. PlatformMeta: description: >- Configurações por rede de um destino. Use o formato da rede do destino. Chaves sem regra são descartadas. Toda chave conhecida é validada qualquer que seja a rede, mas só as chaves da rede do destino são usadas na publicação. Na atualização, `meta` é mesclado com as configurações salvas: envie `null` numa chave para limpá-la (vale para textos, listas e objetos; booleanos não podem ser limpos, então envie `true` ou `false`), e `thread_replies` substitui a lista inteira. Obrigatório para agendar ou publicar: `privacy_level` no TikTok, `board_id` no Pinterest, `channel_id` no Discord, `event` no Google Business em `EVENT` e `OFFER` e, no YouTube, um título (`title` ou a primeira linha do texto). `GET /content-types` lista em `required_meta` os obrigatórios incondicionais de cada rede (TikTok, Pinterest e Discord). anyOf: - $ref: '#/components/schemas/PlatformMetaX' - $ref: '#/components/schemas/PlatformMetaBluesky' - $ref: '#/components/schemas/PlatformMetaMastodon' - $ref: '#/components/schemas/PlatformMetaTikTok' - $ref: '#/components/schemas/PlatformMetaPinterest' - $ref: '#/components/schemas/PlatformMetaDiscord' - $ref: '#/components/schemas/PlatformMetaYouTube' - $ref: '#/components/schemas/PlatformMetaInstagram' - $ref: '#/components/schemas/PlatformMetaThreads' - $ref: '#/components/schemas/PlatformMetaFacebook' - $ref: '#/components/schemas/PlatformMetaLinkedIn' - $ref: '#/components/schemas/PlatformMetaGoogleBusiness' - $ref: '#/components/schemas/PlatformMetaNone' PlatformMetaX: type: object title: X description: Configurações de `x_post`. properties: thread_replies: type: - array - 'null' maxItems: 24 description: >- Até 24 respostas publicadas abaixo do post, formando uma sequência. Cada item é um `ThreadReply` ou uma string simples para uma resposta só de texto. Na atualização, esta lista substitui a salva. items: oneOf: - type: string maxLength: 25000 title: Resposta só de texto - $ref: '#/components/schemas/ThreadReply' is_ai_generated: type: boolean description: >- Informa que a mídia do post foi gerada por IA (enviado ao X como `made_with_ai`). PlatformMetaBluesky: type: object title: Bluesky description: Configurações de `bluesky_post`. properties: thread_replies: type: - array - 'null' maxItems: 24 description: >- Até 24 respostas publicadas abaixo do post, formando uma sequência. Cada item é um `ThreadReply` ou uma string simples para uma resposta só de texto. Na atualização, esta lista substitui a salva. items: oneOf: - type: string maxLength: 25000 title: Resposta só de texto - $ref: '#/components/schemas/ThreadReply' link_preview: type: boolean default: true description: >- Envie `false` (um booleano de verdade, não a string) para publicar um post de texto com link sem o cartão de prévia. PlatformMetaMastodon: type: object title: Mastodon description: Configurações de `mastodon_post`. properties: thread_replies: type: - array - 'null' maxItems: 24 description: >- Até 24 respostas publicadas abaixo do post, formando uma sequência. Cada item é um `ThreadReply` ou uma string simples para uma resposta só de texto. Na atualização, esta lista substitui a salva. items: oneOf: - type: string maxLength: 25000 title: Resposta só de texto - $ref: '#/components/schemas/ThreadReply' spoiler_text: type: - string - 'null' maxLength: 500 description: Aviso de conteúdo. Conta no limite de 500 caracteres do post. PlatformMetaTikTok: type: object title: TikTok description: >- Configurações de `tiktok_video` e `tiktok_photo`. `privacy_level` é obrigatório para agendar ou publicar; leia os valores permitidos em `GET /social-accounts/{account}/tiktok-creator-info` e mantenha `allow_comments`, `allow_duet` e `allow_stitch` como `false` quando ele os informar desativados. `SELF_ONLY` não pode ser usado junto com `brand_content_toggle`. properties: privacy_level: type: - string - 'null' enum: - PUBLIC_TO_EVERYONE - MUTUAL_FOLLOW_FRIENDS - FOLLOWER_OF_CREATOR - SELF_ONLY - null description: Quem pode ver o post. Obrigatório para agendar ou publicar. allow_comments: type: boolean description: Permite comentários. allow_duet: type: boolean description: Permite dueto. Só `tiktok_video`. allow_stitch: type: boolean description: Permite costura (stitch). Só `tiktok_video`. is_aigc: type: boolean description: Selo de conteúdo gerado por IA. Só `tiktok_video`. auto_add_music: type: boolean description: Adiciona música automaticamente. Só `tiktok_photo`. disclose: type: boolean description: Declaração de conteúdo comercial. brand_content_toggle: type: boolean description: Parceria paga. brand_organic_toggle: type: boolean description: Divulga a sua própria marca. PlatformMetaPinterest: type: object title: Pinterest description: >- Configurações de `pinterest_pin`, `pinterest_video_pin` e `pinterest_carousel`. A descrição do pin é o texto do post; a capa de um pin de vídeo é o `meta.cover_offset_ms` do item de mídia. properties: board_id: type: - string - 'null' description: >- Pasta onde o pin será salvo. Obrigatório para agendar ou publicar. Liste as pastas com `GET /social-accounts/{account}/boards` ou crie uma com `POST /social-accounts/{account}/boards`. title: type: - string - 'null' maxLength: 100 description: Título do pin. link: type: - string - 'null' format: uri maxLength: 2048 description: URL de destino (`http` ou `https`). PlatformMetaDiscord: type: object title: Discord description: Configurações de `discord_message`. properties: channel_id: type: - string - 'null' description: >- Canal onde a mensagem será enviada. Obrigatório para agendar ou publicar. Liste os canais com `GET /social-accounts/{account}/channels`. channel_name: type: - string - 'null' description: >- Nome do canal mostrado no app. É salvo como enviado; o PostClean não o confere com `channel_id`. mentions: type: - array - 'null' items: type: object required: - token properties: token: type: string description: Token da menção, por exemplo `@everyone` ou `<@&roleId>`. label: type: - string - 'null' description: Rótulo mostrado no app. description: Menções incluídas na mensagem. embeds: type: - array - 'null' maxItems: 10 items: type: object properties: title: type: - string - 'null' maxLength: 256 description: Título do embed. description: type: - string - 'null' maxLength: 4096 description: Texto do embed. url: type: - string - 'null' format: uri description: Link do título. image: type: - string - 'null' format: uri description: URL da imagem. color: type: - string - 'null' pattern: ^#?[0-9A-Fa-f]{6}$ description: Cor em hexadecimal, `#RRGGBB`. description: Até 10 embeds. PlatformMetaYouTube: type: object title: YouTube description: >- Configurações de `youtube_short`. Para agendar ou publicar, o post precisa de `title` ou de texto. properties: title: type: - string - 'null' maxLength: 100 description: >- Sem `<` nem `>` (recusado até em rascunhos). Se omitido, vira a primeira linha não vazia do texto, sem `<` e `>`, cortada em 100 caracteres. description: type: - string - 'null' description: >- Texto simples, no máximo 5000 bytes. Omita ou envie `null` para usar o texto do post. category_id: type: - string - 'null' enum: - '1' - '2' - '10' - '15' - '17' - '19' - '20' - '22' - '23' - '24' - '25' - '26' - '27' - '28' - '29' - null default: '22' description: >- Categoria do YouTube: 1 Filmes e animação, 2 Autos e veículos, 10 Música, 15 Animais de estimação, 17 Esportes, 19 Viagens e eventos, 20 Jogos, 22 Pessoas e blogs, 23 Comédia, 24 Entretenimento, 25 Notícias e política, 26 Guias e estilo, 27 Educação, 28 Ciência e tecnologia, 29 ONGs e ativismo. Um id inteiro é aceito e salvo como string. privacy_status: type: - string - 'null' enum: - public - unlisted - private - null default: public description: Visibilidade do vídeo. license: type: - string - 'null' enum: - youtube - creativeCommon - null default: youtube description: Licença do vídeo. notify_subscribers: type: boolean default: true description: Avisa os inscritos. embeddable: type: boolean default: true description: Permite incorporar o vídeo em outros sites. made_for_kids: type: boolean default: false description: Conteúdo feito para crianças. is_ai_generated: type: boolean description: Informa conteúdo alterado ou sintético. PlatformMetaInstagram: type: object title: Instagram description: >- Configurações de `instagram_feed`, `instagram_reel` e `instagram_story` (contas `instagram` e `instagram-facebook`). Um `instagram_feed` com um único vídeo é publicado como Reel. As pessoas marcadas ficam em `meta.user_tags` do item de mídia, e a capa de um vídeo em `meta.cover_offset_ms`. Um post pode ter no máximo 5 hashtags. properties: is_ai_generated: type: boolean description: Selo de conteúdo gerado por IA (feed, reels, stories e carrosséis). share_to_feed: type: boolean default: true description: 'Só `instagram_reel`: mostra o Reel também no feed do perfil.' PlatformMetaThreads: type: object title: Threads description: >- Configurações de `threads_post`. Use o tipo `threads_ghost_post` para um post só de texto arquivado depois de 24 horas (sem mídia e sem tópico). properties: topic_tag: type: - string - 'null' description: >- Tópico, de 1 a 50 caracteres depois de remover um `#` no início, sem `.` nem `&`. PlatformMetaFacebook: type: object title: Facebook description: >- Configurações de `facebook_post`. Reels e stories do Facebook não têm configurações; stories não publicam texto. properties: link_preview: type: boolean default: true description: >- Envie `false` (um booleano de verdade, não a string) para publicar um post de texto com link sem o cartão de prévia. PlatformMetaLinkedIn: type: object title: LinkedIn description: >- Configurações de `linkedin_post` e `linkedin_page_post`. O LinkedIn não aceita `thread_replies`. properties: link_preview: type: boolean default: true description: >- Envie `false` (um booleano de verdade, não a string) para publicar um post de texto com link sem o cartão de prévia. document_title: type: - string - 'null' maxLength: 300 description: >- Título mostrado num post de documento PDF. Padrão: o nome do arquivo. PlatformMetaGoogleBusiness: type: object title: Google Business Profile description: >- Configurações de `google_business_post`. Um `EVENT` ou `OFFER` precisa de `event.title`, `event.start_date` e `event.end_date` (na oferta, o título é o da oferta) e não pode terminar antes de começar. properties: topic_type: type: - string - 'null' enum: - STANDARD - EVENT - OFFER - null default: STANDARD description: Tipo do post. call_to_action: type: - object - 'null' description: Botão do post. Não vale em `OFFER`. properties: action_type: type: - string - 'null' enum: - NONE - BOOK - ORDER - SHOP - LEARN_MORE - SIGN_UP - CALL - null description: Ação do botão. url: type: - string - 'null' format: uri maxLength: 2048 description: Obrigatória, exceto quando `action_type` é `NONE` ou `CALL`. event: type: - object - 'null' description: Obrigatório em `EVENT` e `OFFER`. properties: title: type: - string - 'null' maxLength: 58 description: Título do evento ou da oferta. start_date: type: - string - 'null' format: date description: '`AAAA-MM-DD`.' end_date: type: - string - 'null' format: date description: '`AAAA-MM-DD`, não antes de `start_date`.' start_time: type: - string - 'null' pattern: ^\d{2}:\d{2}$ description: '`HH:MM`.' end_time: type: - string - 'null' pattern: ^\d{2}:\d{2}$ description: '`HH:MM`. No mesmo dia, não antes de `start_time`.' offer: type: - object - 'null' description: Só `OFFER`. properties: coupon_code: type: - string - 'null' description: Código do cupom. redeem_online_url: type: - string - 'null' format: uri maxLength: 2048 description: Link para resgatar a oferta. terms_conditions: type: - string - 'null' maxLength: 5000 description: Termos e condições. PlatformMetaNone: type: object title: Telegram description: Telegram (e reels e stories do Facebook) não têm configurações. properties: {} ThreadReply: type: object description: >- Uma resposta publicada abaixo do post, formando uma sequência (X, Bluesky e Mastodon). Uma resposta precisa de texto ou de mídia. O texto precisa caber no limite da conta (Bluesky 300, Mastodon 500 contando o aviso de conteúdo, que se repete em cada resposta, X 280 ou 25000 para contas com posts longos). As mídias pertencem só a esta resposta e seguem as regras de mídia de um post nessa rede. Em outras redes, agendar ou publicar com `thread_replies` falha com `Threads of posts are not available on this network.` properties: text: type: - string - 'null' maxLength: 25000 description: Texto da resposta. media: type: - array - 'null' maxItems: 4 description: >- Até 4 itens de mídia, cada um dado por `url`, `id` ou `upload_token`, com `meta.alt_text` opcional. items: $ref: '#/components/schemas/MediaReference' examples: - text: 3/ O changelog completo está abaixo. media: - url: https://example.com/changelog.png MediaReference: type: object description: >- Um item de mídia para colocar num post. Informe **exatamente um** entre `upload_token`, `url` e `id`; caso contrário o pedido falha com `Each media item needs exactly one of upload_token, url or id.` properties: upload_token: type: string format: uuid description: >- Token de `POST /uploads` ou de uma URL assinada. Uso único: o primeiro post que o recebe o consome. Vale 24 horas. url: type: string format: uri maxLength: 2048 description: >- URL pública `http` ou `https` do próprio arquivo. É baixada uma vez por pedido; redirecionamentos não são seguidos e hosts privados são recusados. id: type: string format: uuid description: >- Id de uma mídia que já está neste workspace (por exemplo o `media[].id` de outro post). O arquivo é copiado. alt: type: - string - 'null' maxLength: 2000 description: >- Atalho para o texto alternativo. Vale só para imagens; `meta.alt_text` prevalece quando os dois são enviados. meta: $ref: '#/components/schemas/MediaItemMeta' examples: - url: https://example.com/lancamento.jpg alt: Banner de lançamento do produto MediaItemMeta: type: object description: >- Configurações editáveis de um item de mídia. As respostas também podem trazer chaves medidas pelo servidor (por exemplo `width`, `height` e `duration`). properties: alt_text: type: string maxLength: 2000 description: >- Descrição de acessibilidade. Vale para imagens; cada rede corta no próprio limite. user_tags: type: array maxItems: 20 description: Pessoas marcadas numa imagem do Instagram (só `instagram_feed`). items: type: object required: - username - x - 'y' properties: username: type: string pattern: ^@?[A-Za-z0-9._]{1,30}$ description: >- Nome de usuário público do Instagram. Um `@` no início é removido. x: type: number minimum: 0 maximum: 1 description: Distância da borda esquerda, de 0 a 1. 'y': type: number minimum: 0 maximum: 1 description: Distância da borda de cima, de 0 a 1. cover_offset_ms: type: integer minimum: 0 description: >- Quadro do vídeo usado como capa, em milissegundos a partir do início. Não pode passar do fim do vídeo. responses: Unauthorized: description: >- Chave de API ausente, inválida, revogada ou expirada. Corpos possíveis: `Unauthenticated.` (sem chave, ou chave inválida ou revogada), `Token expired.` (passou do `expires_at`), `Token not found.` e `No workspace selected.` (a chave não está mais ligada a um workspace). content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: message: Unauthenticated. PaymentRequired: description: >- A conta do workspace não tem assinatura ativa nem período de teste. Corpo: `{"message": "Active subscription required."}`. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: message: Active subscription required. Forbidden: description: >- A requisição não é permitida. Chaves de API só funcionam para administradores do workspace (o dono da conta ou um membro marcado como administrador); fora isso, toda requisição devolve `Insufficient workspace permissions.`. Outros corpos: `Workspace access denied.` (o usuário da chave saiu do workspace), `Personal access token required.` (foi enviado um token OAuth do MCP) e `This action is unauthorized.` (por exemplo, a nota pertence a outro membro). content: application/json: schema: $ref: '#/components/schemas/ErrorBody' NotFound: description: O recurso não existe neste workspace. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' ValidationError: description: A validação falhou. Cada campo com erro aparece em `errors`. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorBody' TooManyRequests: description: 'Limite de requisições excedido: 60 por minuto por workspace.' headers: Retry-After: description: Segundos de espera antes de tentar de novo. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorBody' example: name: rate_limit_exceeded message: Rate limit exceeded. Please retry after 30 seconds. securitySchemes: bearerAuth: type: http scheme: bearer description: Chave de API do workspace, criada em Configurações > Chaves de API. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.