Skip to main content
PATCH
Edit connected app

Authorizations

Authorization
string
header
required

Access token issued by gtm.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Path Parameters

sid
string
required

OAuth authorization (grant) sid (id_oa_…).

Required string length: 18
Pattern: ^id_oa_

Body

application/json

Request body of update_oauth_authorization.

team_scope_mode
enum<string>
Available options:
selected,
all_my_teams
consented_team_sids
string[]

FULL replacement; required + non-empty when the effective mode is selected; ignored for all_my_teams.

Required string length: 18
Pattern: ^ts_tm_
permissions
string[]

FULL replacement; MUST be ⊆ the client's permission ceiling.

Maximum string length: 128

Response

update success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
update
item
object
required
updated_fields
string[]
required
previous_values
object
required
meta
object
required