SOsocket-dev
api-tokens

Update API Token

Changed on

Update an API Token. The API Token created must use a subset of permissions the API token creating them.

This endpoint consumes 10 units of your quota.

This endpoint requires the following org token scopes:

  • api-tokens:create
post/orgs/{org_slug}/api-tokens/update

Request

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

Path parameters

org_slugstring required

The slug of the organization

Request body

max_quotainteger required

Maximum number of API calls allowed per hour

scopesstring[] required

List of scopes granted to the API Token

visibility'admin' | 'organization' required

The visibility of the API Token. Warning: this field is deprecated and will be removed in the future.

namestring

Name for the API Token

uuidstring uuid

The stable group UUID to update (provide uuid, id, token, or hash. May provide uuid+hash together for validation)

idstring

The API token ID to update (provide uuid, id, token, or hash)

tokenstring

The API token to update (provide uuid, id, token, or hash)

hashstring

The API token hash to update (provide uuid, id, token, or hash)

Response

The updated token.

hashstring required

Token digest (sha512-base64hash or hmac-sha256-base64hash)

Changes

  • 5ad8bf36b1e7Revision changes
    • info

      added the new alert-policy enum value to the request property /

    • info

      added the new alert-policy:create enum value to the request property /

    • info

      added the new alert-policy:delete enum value to the request property /

    • info

      added the new alert-policy:list enum value to the request property /

    • info

      added the new alert-policy:read enum value to the request property /

    • info

      added the new alert-policy:update enum value to the request property /

    • info

      added the new selected-organization enum value to the request property /

    • info

      added the new socket-firewall-deployment enum value to the request property /

    • info

      added the new socket-firewall-deployment:update enum value to the request property /

    • info

      added the new vulnerability-feed enum value to the request property /

    • info

      added the new vulnerability-feed:list enum value to the request property /