Browse the API reference

Create API Key

post/v1/user/api-keys

Part of User.

The raw key value is only returned once at creation time and cannot be retrieved again.

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Request body

Required, application/json.

Field	Type	Description
`name`required	string	Name for the API key
`description`optional	string	Optional description
`expires_at`optional	string	Optional expiration date in ISO format (e.g. 2024-12-31T23:59:59Z)
`graph_id`optional	string	Optional graph scope. A scoped key works only for this graph (and its subgraphs) and is the only kind of key accepted in an MCP connector URL. Omit for an account-wide key.

Example request

curl

curl -X POST "https://api.robosystems.ai/v1/user/api-keys" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

Responses

201 Successful Response

Field Type Description

api_keyrequired

APIKeyInfo

API key information

APIKeyInfo fields

Field	Type	Description
`id`required	string	API key ID
`name`required	string	API key name
`description`optional	string	API key description
`prefix`required	string	API key prefix for identification
`is_active`required	boolean	Whether the key is active
`last_used_at`optional	string	Last used timestamp
`expires_at`optional	string	Expiration timestamp
`created_at`required	string	Creation timestamp
`graph_id`optional	string	Graph scope; null means account-wide

keyrequired

string

The actual API key (only shown once)

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
422	Validation Error
429	Rate limit exceeded
500	Internal server error