---
title: "Dashboard update post"
method: PATCH
path: "/v1/dashboard/posts/{postId}"
tags: ["Dashboard Browser API"]
---

# Dashboard update post

`PATCH /v1/dashboard/posts/{postId}`

## Request

- Base URL: `https://getsocialclaw.com`
- URL: `https://getsocialclaw.com/v1/dashboard/posts/{postId}`
- Auth: API key in cookie `socialclaw_dash_session`

Updates an editable dashboard timeline post.

## Path parameters

- `postId` string, required

## Request body

- DashboardPostUpdateRequest: Updates an editable dashboard timeline post.
  - `title` string, nullable: Updated title.
  - `text` string, nullable: Updated text.
  - `account` string, required: Account handle.
  - `assets` AssetInput[]: Updated media assets.
    - `id` string, nullable: Client-side or SocialClaw asset id.
    - `url` string, required: Publicly reachable media URL.
    - `managed` boolean: True when this is a SocialClaw-managed asset.
    - `originalFilename` string, nullable: Original file name.
    - `mime` string, nullable: MIME type.
    - `kind` 'image' | 'video' | 'audio' | 'other' | 'null', nullable
    - `size` integer, nullable: File size in bytes.
    - `duration` number, nullable: Duration in seconds for video/audio.
    - `width` integer, nullable: Media width in pixels.
    - `height` integer, nullable: Media height in pixels.
    - `altText` string, nullable: Alt text where the provider supports it.
  - `settings` object
  - `timezone` string, nullable: IANA timezone.
  - `publishAt` string, date-time, required: Updated publish time.

## Response `200`

Successful response.

- PostResponse: Single post response.
  - `ok` unknown, required
  - `post` Post, required: Scheduled or published post record.
    - `id` string, required: Post id.
    - `runId` string, nullable: Run id.
    - `provider` 'x' | 'threads' | 'meta' | 'facebook' | 'instagram_business' | 'instagram' | 'snapchat' | 'tiktok' | 'linkedin' | 'linkedin_page' | 'pinterest' | 'youtube' | 'reddit' | 'discord' | 'telegram' | 'wordpress', required
    - `account` string, required: Connected account handle.
    - `accountId` string, nullable: Connected account id.
    - `status` 'draft' | 'scheduled' | 'publishing' | 'published' | 'action_required' | 'retry_pending' | 'failed' | 'canceled', required
    - `name` string, nullable: Post name or title.
    - `description` string, nullable: Post body text.
    - `publishAtUtc` string, date-time, nullable: UTC publish time.
    - `providerPostId` string, nullable: Provider-side post id after publish.
    - `providerUrl` string, uri, nullable: Provider-side URL when available.
    - `error` string, nullable: Last error message.
    - `attempts` integer: Publish attempt count.

## Other responses

- `400`: Invalid request.
- `401`: Missing, invalid, or unauthorized credentials.
- `404`: Requested resource was not found.
- `422`: Request body or semantic validation failed.

---

[API](https://skmtc.dev/getsocialclaw/apis/socialclaw-api.md) · [All operations](https://skmtc.dev/getsocialclaw/apis/socialclaw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getsocialclaw/apis/socialclaw-api/revisions/a11a6a5b9bc6?raw)