Skip to content

Tags

The labels posts are filed under.

2 endpoints

GET/groups/{groupId}/tags

The tag vocabulary

Any key

A key limited to some groups lists only the tags used by posts in those groups.

Path

  • groupIduuidrequired

    A social group id from GET /groups.

Returns

200 with these fields; an error answers in the Error envelope.

curl https://postacio.com/api/v1/groups/$GROUP_ID/tags \
  -H "Authorization: Bearer $POSTACIO_API_KEY"
POST/groups/{groupId}/tags

Create a tag, or return the one with that name

Any keyIdempotency-Key

Path

  • groupIduuidrequired

    A social group id from GET /groups.

Headers

  • Idempotency-Keystring

    Up to 128 visible ASCII characters. Retrying with the same key and body within 24 hours replays the first answer (with Idempotent-Replayed: true) instead of doing the work twice; the same key with a different body is 422 idempotency_conflict.

    up to 128 characters

Body

  • namestringrequired

    Matched case-insensitively: an existing tag with this name is returned, not duplicated. A key limited to some groups may get back the name and colour it sent rather than the stored ones; the id is authoritative.

    1 to 40 characters

  • colorstring
    slategreenamberredblueviolettealpink

Returns

201 with a Tag object; an error answers in the Error envelope.

curl -X POST https://postacio.com/api/v1/groups/$GROUP_ID/tags \
  -H "Authorization: Bearer $POSTACIO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "name": "launch",
    "color": "blue"
  }'

Ready to send your first draft?

Start your free trial, create a key in Settings, and call the API in a minute.

Start free trialRead the guide