Patch access token | LaunchDarkly

curl -X PATCH https://app.launchdarkly.com/api/v2/tokens/id \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '[
  {
    "op": "replace",
    "path": "/role",
    "value": null
  }
]'

{
  "_id": "61095542756dba551110ae21",
  "ownerId": "569f514156e003339cfd3917",
  "memberId": "569f514183f2164430000002",
  "creationDate": 1628001602644,
  "lastModified": 1628001602644,
  "_links": {
    "parent": {
      "href": "/api/v2/tokens",
      "type": "application/json"
    },
    "self": {
      "href": "/api/v2/tokens/61095542756dba551110ae21",
      "type": "application/json"
    }
  },
  "_member": {
    "_links": {
      "self": {
        "href": "/api/v2/members/569f183514f4432160000007",
        "type": "application/json"
      }
    },
    "_id": "569f183514f4432160000007",
    "role": "admin",
    "email": "ariel@acme.com",
    "firstName": "Ariel",
    "lastName": "Flores"
  },
  "name": "Example reader token",
  "description": "A reader token used in testing and examples",
  "customRoleIds": [],
  "inlineRole": [],
  "role": "reader",
  "token": "1234",
  "serviceToken": false,
  "defaultApiVersion": 20240415,
  "lastUsed": 0
}

Update an access token's settings. Updating an access token uses a [JSON patch](https://datatracker.ietf.org/doc/html/rfc6902) representation of the desired changes. To learn more, read [Updates](https://launchdarkly.com/docs/api#updates).

curl -X PATCH https://app.launchdarkly.com/api/v2/tokens/id \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '[
  {
    "op": "replace",
    "path": "/role",
    "value": null
  }
]'

{
  "_id": "61095542756dba551110ae21",
  "ownerId": "569f514156e003339cfd3917",
  "memberId": "569f514183f2164430000002",
  "creationDate": 1628001602644,
  "lastModified": 1628001602644,
  "_links": {
    "parent": {
      "href": "/api/v2/tokens",
      "type": "application/json"
    },
    "self": {
      "href": "/api/v2/tokens/61095542756dba551110ae21",
      "type": "application/json"
    }
  },
  "_member": {
    "_links": {
      "self": {
        "href": "/api/v2/members/569f183514f4432160000007",
        "type": "application/json"
      }
    },
    "_id": "569f183514f4432160000007",
    "role": "admin",
    "email": "ariel@acme.com",
    "firstName": "Ariel",
    "lastName": "Flores"
  },
  "name": "Example reader token",
  "description": "A reader token used in testing and examples",
  "customRoleIds": [],
  "inlineRole": [],
  "role": "reader",
  "token": "1234",
  "serviceToken": false,
  "defaultApiVersion": 20240415,
  "lastUsed": 0
}

Update an access token’s settings. Updating an access token uses a JSON patch representation of the desired changes. To learn more, read Updates.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

idstringRequiredformat: "string"

The ID of the access token to update

Request

This endpoint expects a list of objects.

opstringRequired

The type of operation to perform

pathstringRequired

A JSON Pointer string specifying the part of the document to operate on

valueanyOptional

A JSON value used in "add", "replace", and "test" operations

Response

Access token response

_idstring

The ID of the access token

ownerIdstring

The ID of the owner of the account for the access token

memberIdstring

The ID of the member who created the access token

creationDatelong

Timestamp of when the access token was created

lastModifiedlong

Timestamp of the last modification of the access token

_linksmap from strings to objects

The location and content type of related resources

_memberobject

Details on the member who created the access token

namestring

A human-friendly name for the access token

descriptionstring

A description for the access token

customRoleIdslist of strings

A list of custom role IDs to use as access limits for the access token

inlineRolelist of objects

An array of policy statements, with three attributes: effect, resources, actions. May be used in place of a role.

rolestring

Base role for the token

tokenstring

The token value. When creating or resetting, contains the entire token value. Otherwise, contains the last four characters.

serviceTokenboolean

Whether this is a service token or a personal token

defaultApiVersioninteger

The default API version for this token

lastUsedlong

Timestamp of when the access token was last used

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

$	curl -X PATCH https://app.launchdarkly.com/api/v2/tokens/id \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '[
>	{
>	"op": "replace",
>	"path": "/role",
>	"value": null
>	}
>	]'

1	{
2	"_id": "61095542756dba551110ae21",
3	"ownerId": "569f514156e003339cfd3917",
4	"memberId": "569f514183f2164430000002",
5	"creationDate": 1628001602644,
6	"lastModified": 1628001602644,
7	"_links": {
8	"parent": {
9	"href": "/api/v2/tokens",
10	"type": "application/json"
11	},
12	"self": {
13	"href": "/api/v2/tokens/61095542756dba551110ae21",
14	"type": "application/json"
15	}
16	},
17	"_member": {
18	"_links": {
19	"self": {
20	"href": "/api/v2/members/569f183514f4432160000007",
21	"type": "application/json"
22	}
23	},
24	"_id": "569f183514f4432160000007",
25	"role": "admin",
26	"email": "ariel@acme.com",
27	"firstName": "Ariel",
28	"lastName": "Flores"
29	},
30	"name": "Example reader token",
31	"description": "A reader token used in testing and examples",
32	"customRoleIds": [],
33	"inlineRole": [],
34	"role": "reader",
35	"token": "1234",
36	"serviceToken": false,
37	"defaultApiVersion": 20240415,
38	"lastUsed": 0
39	}