Change a request type

PATCH

/v1/portals/{portalId}/request-types/{requestTypeId}

const url = 'https://api.pealboard.com/v1/portals/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/request-types/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"example","description":"example","form":[{"key":"example","label":"example","type":"text","required":false,"options":["example"],"helpText":"example"}],"destination":{"repositoryId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","labels":[],"projectNodeId":"example","initialFieldValues":{},"issueType":"example"},"statusMap":[{"when":{"kind":"closed","stateReason":"completed"},"status":"Open"}],"position":1}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PATCH \
  --url https://api.pealboard.com/v1/portals/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/request-types/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "description": "example", "form": [ { "key": "example", "label": "example", "type": "text", "required": false, "options": [ "example" ], "helpText": "example" } ], "destination": { "repositoryId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "labels": [], "projectNodeId": "example", "initialFieldValues": {}, "issueType": "example" }, "statusMap": [ { "when": { "kind": "closed", "stateReason": "completed" }, "status": "Open" } ], "position": 1 }'

Changing statusMap changes the status word every existing request of this type shows, at once and retroactively. That is the intended behaviour — status is derived and never stored — and it is recorded in the audit log.

Access. Requires the admin role or above (admin, owner). Changing a destination changes where every future submission of this kind lands. API-key scope: portals:write.

Authorizations

bearerAuth

Parameters

Path Parameters

portalId

required

From GET /v1/portals.

string format: uuid

From GET /v1/portals.

requestTypeId

required

A UUID this API issued.

string format: uuid

A UUID this API issued.

Request Body

application/json

object

name

string

>= 1 characters <= 80 characters

description

string | null

<= 500 characters

form

Array<object>

<= 30 items

object

key

required

The key a submission sends this field’s value under.

string

>= 1 characters <= 60 characters /^[a-z0-9_]+$/

label

required

The heading this field becomes in the issue body.

string

>= 1 characters <= 120 characters

type

required

Text is one line and textarea is many. select needs options; every other type ignores them.

string

Allowed values: text textarea select checkbox email url number date

required

boolean

options

Array<string>

<= 50 items

helpText

string

<= 300 characters

destination

object

repositoryId

Where the issue is created. Required.

string format: uuid

labels

Array<string>

default: <= 20 items

projectNodeId

string | null

>= 1 characters

initialFieldValues

object

key

additional properties

issueType

string | null

>= 1 characters

statusMap

Array<object>

<= 30 items

First match wins, in the order given. An empty list means the default rules in ADR 0009.

object

when

required

One of:

object

kind

required

string

Allowed values: closed

stateReason

required

string | null

Allowed values: completed not_planned duplicate

status

required

The customer-facing word. Seven, fixed, and never GitHub’s own vocabulary.

string

Allowed values: Open Planned In progress Waiting on you Completed Merged Closed

position

integer

<= 999

Responses

200

The request type.

application/json

object

required

A UUID this API issued.

string format: uuid

portalId

required

A UUID this API issued.

string format: uuid

name

required

string

description

required

string | null

form

required

Array<object>

object

key

required

The key a submission sends this field’s value under.

string

>= 1 characters <= 60 characters /^[a-z0-9_]+$/

label

required

The heading this field becomes in the issue body.

string

>= 1 characters <= 120 characters

type

required

Text is one line and textarea is many. select needs options; every other type ignores them.

string

Allowed values: text textarea select checkbox email url number date

required

boolean

options

Array<string>

<= 50 items

helpText

string

<= 300 characters

destination

required

object

repositoryId

required

A UUID this API issued.

string format: uuid

repositoryFullName

required

string

labels

required

Array<string>

projectNodeId

required

string | null

initialFieldValues

required

object

key

additional properties

issueType

required

string | null

statusMap

required

Array<object>

First match wins, in the order given. An empty list means the default rules in ADR 0009.

object

when

required

One of:

object

kind

required

string

Allowed values: closed

stateReason

required

string | null

Allowed values: completed not_planned duplicate

status

required

The customer-facing word. Seven, fixed, and never GitHub’s own vocabulary.

string

Allowed values: Open Planned In progress Waiting on you Completed Merged Closed

position

required

integer

createdAt

required

string format: date-time

Example

{
  "form": [
    {
      "type": "text",
      "required": false
    }
  ],
  "statusMap": [
    {
      "when": {
        "kind": "closed",
        "stateReason": "completed"
      },
      "status": "Open"
    }
  ]
}

401

No valid credentials.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

403

Authenticated, but not permitted.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

404

No such resource, or it is not visible to you.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

409

The request conflicts with the current state.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

422

The request did not match the expected shape.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

429

Rate limited. Retry after the interval in the header.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

502

GitHub or another dependency refused or did not answer. Nothing in the workspace changed.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

Change a request type

Authorizations

Parameters

Path Parameters

Request Body

Responses

200

Example

401

Examplegenerated

403

Examplegenerated

404

Examplegenerated

409

Examplegenerated

422

Examplegenerated

429

Examplegenerated

502

Examplegenerated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated