vetta identity social

Social accounts belong to a persona, so every command takes --identity. Reached as vetta identity social <command> — three words, where social is a sub-group rather than a positional argument. See Social publishing for the model.

Commands

Command	Description
`vetta identity social activate`	Activate social publishing for a persona.
`vetta identity social status`	Read the workspace and its connected accounts.
`vetta identity social portal`	Mint the hosted page where a person authorizes accounts.
`vetta identity social accounts`	List the persona’s connected accounts.
`vetta identity social post`	Publish or schedule a post as the persona.
`vetta identity social show`	Read one post.
`vetta identity social rm`	Delete a post.
`vetta identity social upload`	Stage a media file for a post.
`vetta identity social analytics`	Read metrics for a post or an account.
`vetta identity social comments`	List a post’s comments.

--identity takes either an idn_ id or the persona’s name; the API resolves both.

activate

vetta identity social activate --identity ava

Idempotent — re-running answers the same workspace. On a deployment with no social credential bound, this answers 501 feature_not_configured.

status

vetta identity social status --identity ava

{ "object": "social_workspace", "identity_id": "idn_…", "activated": true, "accounts": [] }

portal

vetta identity social portal --identity ava \
  --redirect-url https://studio.example.com/done --platform x --platform linkedin

Flag	Description
`--identity`	Persona id or name (required; also accepted positionally).
`--redirect-url`	Where the person lands after authorizing; defaults to the persona’s studio screen.
`--platform`	Limit the page to these platforms (repeatable).

Nothing changes until a person authorizes an account on the minted page.

accounts

vetta identity social accounts --identity ava

Flag	Description
`--limit`	Page size.
`--after`	Pagination cursor.

post

vetta identity social post --identity ava \
  --message "Shipping day." --platform x --platform linkedin \
  --media-url https://cdn.example.com/launch.mp4

Flag	Description
`--message` / `--text`	The post body (required).
`--title`	Optional title; defaults to the body’s first 100 characters.
`--platform`	Target platform (required, repeatable).
`--schedule-at`	RFC 3339 timestamp; omitted means now.
`--media-url`	A public media URL to attach (repeatable, up to 10).
`--file-id`	A stored `fil_` id to attach (repeatable, up to 10).
`--visibility`	`public`, `unlisted`, or `private`. Only `mastodon` and `youtube` accept it; omitted means the account’s own default.

show / rm

vetta identity social show --identity ava --post <post-id>
vetta identity social rm --identity ava --post <post-id>

upload

vetta identity social upload --identity ava --url https://cdn.example.com/launch.mp4

analytics

vetta identity social analytics --identity ava --post <post-id>
vetta identity social analytics --identity ava --account <account-id>

Pass exactly one of --post or --account.

comments

vetta identity social comments --identity ava --post <post-id>

Flag	Description
`--limit`	Page size.
`--after`	Pagination cursor.

Getting started

Building & running

Organization

Identity

vetta identity social

Commands

activate

status

portal

accounts

post

show / rm

upload

analytics

comments

​Commands

​activate

​status

​portal

​accounts

​post

​show / rm

​upload

​analytics

​comments

Commands

activate

status

portal

accounts

post

show / rm

upload

analytics

comments