Skip to content
PostyAPIv0.3.81
Menu

API reference

Workspaces

List workspaces

get/v1/workspaces

List accessible Posty workspaces and current permissions for the authenticated caller. Returns workspace IDs to use in subsequent tools. This read-only operation needs no workspace selection.

Response 200

Accessible workspaces. OAuth includes current permissions. A key pinned to one workspace returns just that one; a key scoped to its organization returns every workspace in it.

  • workspacesarray of objectrequired
    Child attributes
    • idstringrequired
    • namestring
    • permissionsarray of stringrequired
Request
curl "https://api.posty.social/v1/workspaces" \
  -H "Authorization: Bearer $POSTY_API_KEY"
Response 200
{
  "workspaces": [
    {
      "id": "string",
      "name": "string",
      "permissions": [
        "string"
      ]
    }
  ]
}