# List authorized workspace channels and visible project usage



URL: /docs/reference/channels/listWorkspaceChannels

```json
{"openapi":"3.0.3","info":{"title":"Postdot API","description":"The HTTP API for the lightweight, self-hosted Postdot publication orchestrator.","version":"0.1.0"},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Postdot API key","description":"A user-owned Postdot API key sent as `Authorization: Bearer <token>`. Its project scope is limited by the creator’s current access."},"sessionCookie":{"type":"apiKey","in":"cookie","name":"better-auth.session_token","description":"The Better Auth email/password session cookie used by the web application."}},"schemas":{}},"security":[{"bearerAuth":[]},{"sessionCookie":[]}],"tags":[{"name":"System","description":"Service health and runtime information."},{"name":"Access","description":"Instance membership and invitations."},{"name":"Projects","description":"Project lifecycle and access."},{"name":"Channels","description":"Project publication destinations."},{"name":"Posts","description":"Source posts and publication creation."},{"name":"Publications","description":"Publication workflow operations."},{"name":"Taxonomy","description":"Project categories and publication tags."},{"name":"Media","description":"Project media assets and uploads."},{"name":"Settings","description":"Instance-level runtime configuration."},{"name":"Audit","description":"Project audit history."},{"name":"Notifications","description":"Signed-in user notification inboxes with optional project context."},{"name":"Analytics","description":"Provider-neutral publication and execution analytics."},{"name":"Provider Analytics","description":"Persisted provider-owned metric observations."}],"paths":{"/api/workspaces/{workspaceId}/channels":{"get":{"operationId":"listWorkspaceChannels","summary":"List authorized workspace channels and visible project usage","tags":["Channels"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"includeArchived","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["channels","projects"],"properties":{"channels":{"type":"array","items":{"type":"object","required":["id","workspaceId","name","profileVersionId","profileId","state","archivedAt","revision","createdAt","updatedAt","shared","canManage","canShare","management","usages"],"properties":{"id":{"type":"string"},"workspaceId":{"type":"string"},"name":{"type":"string"},"profileVersionId":{"type":"string"},"profileId":{"type":"string"},"state":{"type":"string","enum":["active","archived"]},"archivedAt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"revision":{"type":"integer"},"createdAt":{"type":"integer"},"updatedAt":{"type":"integer"},"shared":{"type":"boolean"},"canManage":{"type":"boolean"},"canShare":{"type":"boolean"},"management":{"anyOf":[{"type":"object","required":["kind"],"properties":{"kind":{"type":"string","const":"workspace"}}},{"type":"object","required":["kind","project"],"properties":{"kind":{"type":"string","const":"project"},"project":{"anyOf":[{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}},{"type":"null"}]}}}]},"usages":{"type":"array","items":{"type":"object","required":["projectId","name","state","revision"],"properties":{"projectId":{"type":"string"},"name":{"type":"string"},"state":{"type":"string","enum":["active","detached"]},"revision":{"type":"integer"},"canAcceptManagement":{"type":"boolean"}}}}}}},"projects":{"type":"array","items":{"type":"object","required":["id","name","timeZone","canCreate","canAttach"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"timeZone":{"type":"string"},"canCreate":{"type":"boolean"},"canAttach":{"type":"boolean"}}}}}}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"confirmation":{"type":"string"},"warnings":{"type":"array","items":{"type":"object","required":["channelId","rule","period","maximum","count"],"properties":{"channelId":{"type":"string"},"rule":{"type":"string","enum":["daily_max","weekly_max"]},"period":{"type":"string"},"maximum":{"type":"integer"},"count":{"type":"integer"}}}},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"confirmation":{"type":"string"},"warnings":{"type":"array","items":{"type":"object","required":["channelId","rule","period","maximum","count"],"properties":{"channelId":{"type":"string"},"rule":{"type":"string","enum":["daily_max","weekly_max"]},"period":{"type":"string"},"maximum":{"type":"integer"},"count":{"type":"integer"}}}},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Response for status 404","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"confirmation":{"type":"string"},"warnings":{"type":"array","items":{"type":"object","required":["channelId","rule","period","maximum","count"],"properties":{"channelId":{"type":"string"},"rule":{"type":"string","enum":["daily_max","weekly_max"]},"period":{"type":"string"},"maximum":{"type":"integer"},"count":{"type":"integer"}}}},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}},"servers":[{"url":"https://postdot.example","description":"Replace with your Postdot instance origin."}]}
```