> ## Documentation Index > Fetch the complete documentation index at: https://docs.trypost.it/llms.txt > Use this file to discover all available pages before exploring further. # Update posting schedule > Replaces the channel's time zone, posting goal and posting times. Send all seven days, or `posting_schedule: null` to remove every posting time. Every field is written: omitting `posting_goal` or `posting_schedule` clears it like `null`, so send the current values to keep them (read them with `GET /channels/{account}/posting-schedule`). Without posting times, the channel's queued posts become custom-time posts at their current time. Queued posts keep their slot. A schedule change moves only the posts whose slot no longer exists, into the first free slots in order. A time zone change first gives each queued post the slot at the same local time in the new zone, then the first free slots; queue requests pending approval follow the same rule. A queued post with no slot left becomes a custom-time post at its current time. Custom-time posts never move. ## OpenAPI ````yaml /openapi.json put /channels/{account}/posting-schedule openapi: 3.1.0 info: title: TryPost API version: 2.0.0 description: >- REST API for TryPost. Authenticate with a workspace API key as a Bearer token. servers: - url: https://app.trypost.it/api description: TryPost Cloud security: - bearerAuth: [] tags: - name: Posts description: Create, read, update, delete and preview posts. - name: Post notes description: Internal notes on a post, visible to workspace members. - name: Approvals description: Approve or reject posts waiting for approval. - name: Recurrence description: Make a post repeat on a schedule. - name: Media and uploads description: Upload files and attach media to posts. - name: Social accounts description: Connected social accounts and their network-specific options. - name: Channels description: A channel's posting schedule and queue. - name: Ideas description: Ideas on the Create board. - name: Idea stages description: The groups (columns) of the ideas board. - name: Analytics description: Workspace and channel insights. - name: Labels description: Labels to organize posts and ideas. - name: Signatures description: Reusable text to append to posts. - name: Workspace description: The workspace the API key belongs to. - name: API keys description: Personal API keys for this workspace. - name: Webhooks description: Outgoing webhooks and their delivery logs. - name: Repurposes description: Automations that republish videos posted outside TryPost. - name: Platform description: Platform capabilities and content types. paths: /channels/{account}/posting-schedule: parameters: - $ref: '#/components/parameters/AccountId' put: tags: - Channels summary: Update posting schedule description: >- Replaces the channel's time zone, posting goal and posting times. Send all seven days, or `posting_schedule: null` to remove every posting time. Every field is written: omitting `posting_goal` or `posting_schedule` clears it like `null`, so send the current values to keep them (read them with `GET /channels/{account}/posting-schedule`). Without posting times, the channel's queued posts become custom-time posts at their current time. Queued posts keep their slot. A schedule change moves only the posts whose slot no longer exists, into the first free slots in order. A time zone change first gives each queued post the slot at the same local time in the new zone, then the first free slots; queue requests pending approval follow the same rule. A queued post with no slot left becomes a custom-time post at its current time. Custom-time posts never move. operationId: updatePostingSchedule requestBody: required: true content: application/json: schema: type: object required: - timezone properties: timezone: type: string description: IANA time zone, for example `America/Sao_Paulo`. posting_goal: type: - integer - 'null' minimum: 1 maximum: 28 description: >- Posts per week. `null` or omitted clears it: send the current value to keep it. posting_schedule: type: - array - 'null' minItems: 7 maxItems: 7 items: $ref: '#/components/schemas/PostingDay' description: >- Exactly seven days, each `day` once. `null` or omitted removes the posting times (queued posts become custom-time posts): send the current values to keep them. example: 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: [] responses: '200': description: The saved posting schedule. 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' '409': $ref: '#/components/responses/Conflict' '422': $ref: '#/components/responses/ValidationError' '429': $ref: '#/components/responses/TooManyRequests' components: parameters: AccountId: name: account in: path required: true description: >- Social account (channel) id. An account of another workspace returns `404`. schema: type: string format: uuid example: 9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54 schemas: PostingDay: type: object required: - day - enabled - times properties: day: type: integer minimum: 0 maximum: 6 description: >- Day of the week: `0` is Sunday, `6` is Saturday. Send a JSON integer, not a string. enabled: type: boolean description: A disabled day keeps its times but offers no queue slots. times: type: array maxItems: 4 items: type: string pattern: ^\d{2}:\d{2}$ examples: - '09:00' description: >- Posting times, `H:i` in the channel's time zone, at most 4 per day, no duplicates. Stored sorted. ChannelPostingSchedule: type: object properties: id: type: string format: uuid description: Social account id. timezone: type: string description: >- IANA time zone of the channel. Posting times and queue slots are in this zone. posting_goal: type: - integer - 'null' minimum: 1 maximum: 28 description: Posts per week the channel aims for. posting_schedule: type: - array - 'null' items: $ref: '#/components/schemas/PostingDay' description: >- Seven days, Sunday first. `null` when the channel has no posting times (posts cannot use `queue`). ErrorBody: type: object properties: message: type: string ValidationErrorBody: type: object properties: message: type: string errors: type: object additionalProperties: type: array items: type: string RateLimitErrorBody: type: object properties: name: type: string const: rate_limit_exceeded message: type: string examples: - Rate limit exceeded. Please retry after 30 seconds. responses: Unauthorized: description: >- Missing, invalid, revoked or expired API key. Bodies: `Unauthenticated.` (no key, or a key that is invalid or revoked), `Token expired.` (past its `expires_at`), `Token not found.` and `No workspace selected.` (the key is no longer bound to a workspace). content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: message: Unauthenticated. PaymentRequired: description: >- TryPost Cloud only: the workspace's account has no active subscription or trial. Body: `{"message": "Active subscription required."}`. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: message: Active subscription required. Forbidden: description: >- The request is not allowed. API keys work only for workspace admins (the account owner or a member marked as admin): otherwise every request returns `Insufficient workspace permissions.`. Other bodies: `Workspace access denied.` (the key's user left the workspace) and `Personal access token required.` (an MCP OAuth token was sent) and `This action is unauthorized.` (the note belongs to another member). content: application/json: schema: $ref: '#/components/schemas/ErrorBody' NotFound: description: The resource does not exist in this workspace. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' Conflict: description: >- Another change to this post or its channel's queue is in progress. Retry. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' ValidationError: description: Validation failed. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorBody' TooManyRequests: description: 'Rate limit exceeded. Limits: 60 requests per minute per workspace.' headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorBody' securitySchemes: bearerAuth: type: http scheme: bearer description: Workspace API key from Settings → API Keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.