OPopal
owners

POST /owners

Creates an owner.

Request

  • Base URL
    https://api.opal.dev/v1
  • Auth
    HTTP bearer

Request body

namestring required

The name of the owner.

descriptionstring

A description of the owner.

access_request_escalation_periodinteger

The amount of time (in minutes) before the next reviewer is notified. Use 0 to remove escalation policy.

user_idsstring[] required

Users to add to the created owner. If setting a source_group_id this list must be empty.

reviewer_message_channel_idstring

The message channel id for the reviewer channel.

source_group_idstring uuid

Sync this owner's user list with a source group.

Example request

{
  "name": "API Owner",
  "description": "This owner represents the API team owners.",
  "access_request_escalation_period": 120
}

Response

The owner just created.

owner_idstring uuid required

The ID of the owner.

namestring

The name of the owner.

descriptionstring

A description of the owner.

access_request_escalation_periodinteger

The amount of time (in minutes) before the next reviewer is notified. Use 0 to remove escalation policy.

reviewer_message_channel_idstring uuid nullable
source_group_idstring uuid nullable

Example response

{
  "owner_id": "f454d283-ca87-4a8a-bdbb-df212eca5353",
  "name": "API Owner",
  "description": "This owner represents the API team owners.",
  "access_request_escalation_period": 120
}

Changes

No recorded changes to this operation across all 43 revisions of this API.