Delete organization API token

Delete an organization API token.

DELETE
https://api.katapult.io/core/v1/api_tokens/{api_token}

If successful, this endpoint will return a 200 OK status.

Scopes

One of the following scopes are required to use this endpoint.

Arguments

The following arguments are supported for this endpoint.

Name Type Default Value

api_token Required

The API token to destroy

API Token Lookup None

Potential Errors

The following errors may occur during this request.

Details HTTP status

api_token_not_found

No API token was found matching any of the criteria provided in the arguments.

404 Not Found

permission_denied

The authenticated identity is not permitted to perform this action

403 Forbidden

validation_error

A validation error occurred with the object that was being created/updated/deleted

422 Unprocessable Entity

Returned Object

When the request is successful, you can expect an object matching the specification below to be returned.

{
    api_token: APIToken {
        id: String
        name: String
    }
}