Update the access to organization resources via fine-grained personal access tokens

POST

/orgs/{org}/personal-access-tokens

Updates the access organization members have to organization resources via fine-grained personal access tokens. Limited to revoking a token’s existing access.

Only GitHub Apps can use this endpoint.

API method documentation

Parameters

Path Parameters

org

required

string

The organization name. The name is not case sensitive.

Request Body ^required

Media type application/json

object

action

required

Action to apply to the fine-grained personal access token.

string

Allowed values: revoke

pat_ids

required

The IDs of the fine-grained personal access tokens.

Array<integer>

>= 1 items <= 100 items

Examples

Example 204

Example of revoking a fine-grained personal access token.

{
  "action": "revoke",
  "pat_ids": [
    1296269,
    1296280
  ]
}

Responses

202

Accepted

Media type application/json

object

Examples

Example default

null

403

Forbidden

Media type application/json

Basic Error

Basic Error

object

message

string

documentation_url

string

url

string

status

string

Example ^generated

{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

404

Resource not found

Media type application/json

Basic Error

Basic Error

object

message

string

documentation_url

string

url

string

status

string

Example ^generated

{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

422

Validation failed, or the endpoint has been spammed.

Media type application/json

Validation Error

Validation Error

object

message

required

string

documentation_url

required

string

errors

Array<object>

object

resource

string

field

string

message

string

code

required

string

index

integer

value

One of:

string

string

nullable

integer

integer

nullable

Array<string>

Array<string>

nullable

Example ^generated

{
  "message": "example",
  "documentation_url": "example",
  "errors": [
    {
      "resource": "example",
      "field": "example",
      "message": "example",
      "code": "example",
      "index": 1,
      "value": [
        "example"
      ]
    }
  ]
}

500

Internal Error

Media type application/json

Basic Error

Basic Error

object

message

string

documentation_url

string

url

string

status

string

Example ^generated

{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}