> ## 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. # Ver horários de postagem > Retorna o fuso horário do canal, a meta semanal de posts e os horários de postagem. Os horários da fila (`queue: next|top`, `queue_slot`) saem desses horários, no fuso do canal. ## OpenAPI ````yaml /openapi.json get /channels/{account}/posting-schedule 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: /channels/{account}/posting-schedule: parameters: - $ref: '#/components/parameters/AccountId' get: tags: - Channels summary: Ver horários de postagem description: >- Retorna o fuso horário do canal, a meta semanal de posts e os horários de postagem. Os horários da fila (`queue: next|top`, `queue_slot`) saem desses horários, no fuso do canal. operationId: getPostingSchedule responses: '200': description: Os horários de postagem. content: application/json: schema: $ref: '#/components/schemas/ChannelPostingSchedule' example: id: 9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54 timezone: America/Sao_Paulo posting_goal: 5 posting_schedule: - day: 0 enabled: true times: [] - day: 1 enabled: true times: - '09:00' - day: 2 enabled: true times: - '09:00' - '15:00' - day: 3 enabled: true times: - '12:00' - day: 4 enabled: true times: - '09:00' - day: 5 enabled: true times: [] - day: 6 enabled: false times: [] '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/TooManyRequests' components: parameters: AccountId: name: account in: path required: true description: Id da conta social (canal). Uma conta de outro workspace devolve `404`. schema: type: string format: uuid example: 9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54 schemas: ChannelPostingSchedule: type: object properties: id: type: string format: uuid description: Id da conta social. timezone: type: string description: >- Fuso horário IANA do canal. Os horários de postagem e da fila ficam nesse fuso. posting_goal: type: - integer - 'null' minimum: 1 maximum: 28 description: Meta de posts por semana do canal. posting_schedule: type: - array - 'null' items: $ref: '#/components/schemas/PostingDay' description: >- Sete dias, começando no domingo. `null` quando o canal não tem horários de postagem (os posts não podem usar `queue`). PostingDay: type: object required: - day - enabled - times properties: day: type: integer minimum: 0 maximum: 6 description: >- Dia da semana: `0` é domingo, `6` é sábado. Envie um inteiro JSON, não um texto. enabled: type: boolean description: >- Um dia desativado guarda seus horários, mas não oferece horários na fila. times: type: array maxItems: 4 items: type: string pattern: ^\d{2}:\d{2}$ examples: - '09:00' description: >- Horários de postagem, `H:i` no fuso do canal, no máximo 4 por dia, sem repetição. São gravados em ordem. ErrorBody: type: object properties: message: type: string description: Corpo de erro com uma mensagem. 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. 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' 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.