HTTP API reference › Gala Launchpad › Permissions
Gala Launchpad — Permissions
1 operation in this group.
- GET /v1/permissions — Get user permissions for a token
GET /v1/permissions
PermissionsController_getUserPermissions
Get user permissions for a token
Returns the effective permissions for the authenticated user on a specific token. User address is inferred from the JWT token.
Authentication: bearer
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tokenName | query | required | Token name to check permissions for |
Responses
200 — User permissions retrieved successfully
Content type: application/json
Schema: UserPermissionsResponse
| Field | Type | Required | Description |
|---|---|---|---|
| isOverseer | boolean | yes | Whether the user has a platform-wide overseer role |
| isOwner | boolean | yes | Whether the user is the token owner (owners have all permissions) |
| matchedPreset | string nullable enum: MODERATOR, TECHNICAL_PRODUCER, MANAGER | no | If permissions match a role preset exactly, the preset name |
| permissions | array<string> | yes | Array of permission strings the user has for this token |
| source | string nullable enum: owner, moderator_invite, api_key, overseer | yes | Source of the permissions (how access was granted) |
400 — Missing or invalid tokenName parameter
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: true | yes | |
| message | oneOf: string | array<string> | yes | |
| status | integer | yes | HTTP status code. |
| message | string | yes | |
| statusCode | integer | yes | HTTP status code. |
401 — Unauthorized - missing or invalid JWT token
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: true | yes | |
| message | oneOf: string | array<string> | yes | |
| status | integer | yes | HTTP status code. |
| message | string | yes | |
| statusCode | integer | yes | HTTP status code. |
404 — Token not found
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: true | yes | |
| message | oneOf: string | array<string> | yes | |
| status | integer | yes | HTTP status code. |
| message | string | yes | |
| statusCode | integer | yes | HTTP status code. |
default — Shared error envelope returned by the application exception filter.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: true | yes | |
| message | oneOf: string | array<string> | yes | |
| status | integer | yes | HTTP status code. |
| message | string | yes | |
| statusCode | integer | yes | HTTP status code. |
Example response
[]
Previous group: overseers · Next group: content-reactions