Create Management Key

Post org management key via the Junction API. Requires authentication with your team API key.

POST /v1/org/{org_id}/management_key

cURL

curl --request POST \
  --url https://api.management.junction.com/v1/org/{org_id}/management_key \
  --header 'Content-Type: application/json' \
  --header 'X-Vital-Org-Key: <api-key>' \
  --data '{
  "label": "<string>",
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "label": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "creator": {
    "type": "org_member",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "email": "<string>",
    "avatar": "<string>"
  },
  "role": "org_admin",
  "team_role_bindings": [
    {
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "key": "<string>"
}

Junction Management API is available for the Scale plan.

The base URL of this endpoint is https://api.management.junction.com/.

The endpoint accepts only Management Key (X-Management-Key). Team API Key is not accepted.

cURL

curl --request POST \
  --url https://api.management.junction.com/v1/org/{org_id}/management_key \
  --header 'Content-Type: application/json' \
  --header 'X-Vital-Org-Key: <api-key>' \
  --data '{
  "label": "<string>",
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'

Authorizations

X-Management-Key · string · header · required

Path Parameters

org_id · string<uuid> · required

Body

application/json

label · string · required

role · enum<string> · required

Available options: org_admin, team_admin

team_role_bindings · TeamRoleBinding · object[] | null

Show child attributes

Response

200

application/json

Successful Response

id · string<uuid> · required

label · string · required

created_at · string<date-time> · required

creator · CreatorOrgMember · object · required

CreatorOrgMember

CreatorOrgMemberRemoved

CreatorVitalStaff

CreatorManagementKey

Show child attributes

role · enum<string> · required

Available options: org_admin, team_admin

team_role_bindings · TeamRoleBinding · object[] | null · required

Show child attributes

key · string · required