Hub REST API
Identity
The Identity operations of the Hub REST API (3 operations).
For BuildersOpen-source podSynap CloudGenerated from Synap-core/backend@c31e261ab (main)
GET
bearerAuthheader
AuthorizationBearer <API key>Pod API key (Bearer) issued via /api/hub/setup/agent or pod admin tooling. Browser/web clients may use the X-Session-Token header instead. See GET /api/hub/auth/status to introspect the calling key.
discordUserId*stringLength
1 <= lengthLink status
application/json- response
linked*booleansynapUserId?stringdisplayName?stringcurl -X GET 'https://pod.example.com/api/hub/discord/identity?discordUserId=string'Example Response
{ "linked": true, "synapUserId": "string", "displayName": "string"}GET
bearerAuthheader
AuthorizationBearer <API key>Pod API key (Bearer) issued via /api/hub/setup/agent or pod admin tooling. Browser/web clients may use the X-Session-Token header instead. See GET /api/hub/auth/status to introspect the calling key.
workspaceId?stringFormat
uuidLinkable members
application/json- response
members*array<>curl -X GET 'https://pod.example.com/api/hub/discord/identity/members'Example Response
{ "members": [ { "userId": "string", "name": "string" } ]}POST
bearerAuthheader
AuthorizationBearer <API key>Pod API key (Bearer) issued via /api/hub/setup/agent or pod admin tooling. Browser/web clients may use the X-Session-Token header instead. See GET /api/hub/auth/status to introspect the calling key.
application/json- body
discordUserId*stringLength
1 <= lengthmode*stringValue in
"existing""new"targetUserId?stringFormat
uuiddisplayName?stringLength
1 <= length <= 200workspaceId?stringFormat
uuidLinked
application/json- response
linked*trueValue in
truesynapUserId*stringcreated*booleancurl -X POST 'https://pod.example.com/api/hub/discord/identity/link' \ -H 'Content-Type: application/json' \ -d '{ "discordUserId": "string", "mode": "existing"}'Example Response
{ "linked": true, "synapUserId": "string", "created": true}