v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-02-055427357.6 KB
ChatV2Role

post/v2/Services/{ServiceSid}/Roles

Path parameters

ServiceSidstring required

The SID of the Service to create the Role resource under.

Response

Created

sidstring nullable

The unique string that we created to identify the Role resource.

account_sidstring nullable

The SID of the Account that created the Role resource.

service_sidstring nullable

The SID of the Service the Role resource is associated with.

friendly_namestring nullable

The string that you assigned to describe the resource.

type'channel' | 'deployment'

The type of role. Can be: channel for Channel roles or deployment for Service roles.

permissionsstring[] nullable

An array of the permissions the role has been granted.

date_createdstring date-time nullable

The date and time in GMT when the resource was created specified in ISO 8601 format.

date_updatedstring date-time nullable

The date and time in GMT when the resource was last updated specified in ISO 8601 format.

urlstring uri nullable

The absolute URL of the Role resource.