Machines

Create a machine

Creates a new machine.

post/machines

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/machines
  • Auth: HTTP bearer

Request body

namestring required

The name of the machine

scoped_machinesstring[]

Array of machine IDs that this machine will have access to. Maximum of 150 scopes per machine.

default_token_ttlinteger

The default time-to-live (TTL) in seconds for tokens created by this machine. Must be at least 1 second.

Response

Success

object'machine' required
idstring required

Unique identifier for the machine.

namestring required

The name of the machine.

instance_idstring required

The ID of the instance this machine belongs to.

created_atinteger required

Unix timestamp of creation.

updated_atinteger required

Unix timestamp of last update.

default_token_ttlinteger

The default time-to-live (TTL) in seconds for tokens created by this machine.

secret_keystring required

The secret key for the machine, only returned upon creation.

Changes

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