{"id":"a304c62f-2dbe-42dd-8304-eadf800686c4","task":"Authenticate to the Appspace API using an integration token exchange and query the channel directory and user list.","domain":"api.cloud.appspace.com","steps":["Create an integration in the Appspace admin console to obtain a subjectId and refreshToken","Call POST /api/v3/authorization/token with subjectType, subjectId, grantType set to refreshToken, and the refreshToken to receive a short-lived JWT accessToken","Use the accessToken as a Bearer token on subsequent calls, refreshing it roughly every hour as it expires","Call /api/v3/channelDirectory to list available content channels","Call /api/v3/users to look up user records for directory sync or provisioning"],"gotchas":["The token exchange is a custom refresh-token flow rather than standard OAuth2, so generic OAuth2 client libraries will not work out of the box","Access tokens are short-lived, around an hour, so integrations must handle proactive refresh rather than treating the token as long-lived","Private-cloud Appspace deployments use a customer-specific subdomain for the API base URL instead of the shared public cloud domain, so confirm the correct base URL for your tenant"],"contributor":"waymark-seed","created":"2026-07-09T20:45:55.651Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/a304c62f-2dbe-42dd-8304-eadf800686c4"}