Skip to main content
POST
Create a tool

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.

Headers

Idempotency-Key
string

Replays the stored answer for a retry of the same request; 409 for a different request under the same key.

Maximum string length: 255

Body

application/json
definition
object
required

A tool definition (see docs/tools-and-integrations.md).

Response

Created

id
string
required
object
any
required
name
any
description
any
kind
any
status
enum<string>
Available options:
enabled,
disabled
revision
any
parameters
any
auth
any

Secret REFERENCES, reported configured-or-not; values never appear.

request
any
config
any
created_at
any
updated_at
any
archived_at
any