typefully-cli-v2

name	typefully-cli-v2
description	Manage typefully via CLI - me, social-sets, drafts, tags, media. Use when user mentions 'typefully' or wants to interact with the typefully API.

typefully-cli-v2

Setup

If typefully-cli-v2 is not found, install and build it:

bun --version || curl -fsSL https://bun.sh/install | bash
npx api2cli bundle typefully
npx api2cli link typefully

api2cli link adds ~/.local/bin to PATH automatically. The CLI is available in the next command.

Always use --json flag when calling commands programmatically.

Authentication

typefully-cli-v2 auth set "your-token"
typefully-cli-v2 auth test

Resources

me

Command	Description
typefully-cli-v2 me --json	Get authenticated user info

social-sets

Command	Description
typefully-cli-v2 social-sets list --json	List all social sets (accounts)
typefully-cli-v2 social-sets get <id> --json	Get social set details

drafts

Command	Description
typefully-cli-v2 drafts list <social-set-id> --json	List drafts for a social set
typefully-cli-v2 drafts get <social-set-id> <draft-id> --json	Get a specific draft
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --platform x --json	Create a draft
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --platform x,linkedin,threads --json	Create multi-platform draft
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --publish-at now --json	Create and publish immediately
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --publish-at next-free-slot --json	Schedule to next free slot
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --publish-at 2025-02-01T09:00:00Z --json	Schedule at specific time
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --tags marketing,launch --json	Create with tags
typefully-cli-v2 drafts create-raw <social-set-id> --body '{"platforms":{"x":{"enabled":true,"posts":[{"text":"Hello"}]}}}' --json	Create with raw JSON
typefully-cli-v2 drafts update <social-set-id> <draft-id> --text "Updated" --json	Update a draft
typefully-cli-v2 drafts delete <social-set-id> <draft-id> --json	Delete a draft

tags

Command	Description
typefully-cli-v2 tags list <social-set-id> --json	List tags for a social set
typefully-cli-v2 tags create <social-set-id> --name "Marketing" --json	Create a new tag

media

Command	Description
typefully-cli-v2 media upload <social-set-id> --file-name "image.jpg" --json	Get presigned upload URL
typefully-cli-v2 media status <social-set-id> <media-id> --json	Check media processing status

Global Flags

All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header