SOsocket-dev
api-tokens

Rotate API Token

Rotate an API Token

This endpoint consumes 10 units of your quota.

This endpoint requires the following org token scopes:

  • api-tokens:rotate
post/orgs/{org_slug}/api-tokens/rotate

Request

  • Base URL
    https://api.socket.dev/v0
  • URL
    https://api.socket.dev/v0/orgs/{org_slug}/api-tokens/rotate
  • Auth
    • HTTP bearer
    • or HTTP basic

Path parameters

org_slugstring required

The slug of the organization

Request body

uuidstring uuid

The stable group UUID of the API token to rotate

idstring

The API token ID to rotate

tokenstring
hashstring

Response

The replacement API Token with its stable UUID, new token value, and hash

idstring required

The database ID of the new API token

group_uuidstring uuid required

The stable group UUID (unchanged after rotation)

created_bystring uuid nullable required

ID of the Socket user who created the API Token

tokenstring required
hashstring required

Changes

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