> ## 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. # Listar horários livres da fila > Lista os próximos horários livres da fila do canal, do mais próximo para o mais distante: no máximo 30, dentro dos próximos 90 dias e a mais de um minuto de agora. Um horário está ocupado quando um post agendado (da fila ou com horário personalizado) ou um pedido de fila aguardando aprovação está nele. Use um deles como `queue_slot` em `POST /posts` ou como `slot_at` em `PUT /channels/{account}/queue/slot`. Vem vazio quando o canal não tem horários de postagem. ## OpenAPI ````yaml /openapi.json get /channels/{account}/queue/slots 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}/queue/slots: parameters: - $ref: '#/components/parameters/AccountId' get: tags: - Channels summary: Listar horários livres da fila description: >- Lista os próximos horários livres da fila do canal, do mais próximo para o mais distante: no máximo 30, dentro dos próximos 90 dias e a mais de um minuto de agora. Um horário está ocupado quando um post agendado (da fila ou com horário personalizado) ou um pedido de fila aguardando aprovação está nele. Use um deles como `queue_slot` em `POST /posts` ou como `slot_at` em `PUT /channels/{account}/queue/slot`. Vem vazio quando o canal não tem horários de postagem. operationId: listFreeQueueSlots responses: '200': description: Horários livres, como instantes em UTC. content: application/json: schema: type: object properties: slots: type: array maxItems: 30 items: type: string format: date-time description: ISO 8601, em UTC (`Z`). example: slots: - '2026-10-09T12:00:00Z' - '2026-10-12T12:00:00Z' - '2026-10-13T12:00:00Z' '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 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. schemas: 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. 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.