@laburen/delta-cli 0.0.0-stage → 0.2.0-canary.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +33 -2
  3. package/dist/bin.d.ts +2 -0
  4. package/dist/bin.js +16 -0
  5. package/dist/bin.js.map +1 -0
  6. package/dist/commands/agent-checks.d.ts +3 -0
  7. package/dist/commands/agent-checks.js +36 -0
  8. package/dist/commands/agent-checks.js.map +1 -0
  9. package/dist/commands/agent-run/body.d.ts +22 -0
  10. package/dist/commands/agent-run/body.js +88 -0
  11. package/dist/commands/agent-run/body.js.map +1 -0
  12. package/dist/commands/agent-run/render.d.ts +40 -0
  13. package/dist/commands/agent-run/render.js +271 -0
  14. package/dist/commands/agent-run/render.js.map +1 -0
  15. package/dist/commands/agent-run.d.ts +10 -0
  16. package/dist/commands/agent-run.js +205 -0
  17. package/dist/commands/agent-run.js.map +1 -0
  18. package/dist/commands/agent-tools/add.d.ts +5 -0
  19. package/dist/commands/agent-tools/add.js +80 -0
  20. package/dist/commands/agent-tools/add.js.map +1 -0
  21. package/dist/commands/agent-tools/remove.d.ts +5 -0
  22. package/dist/commands/agent-tools/remove.js +126 -0
  23. package/dist/commands/agent-tools/remove.js.map +1 -0
  24. package/dist/commands/agent-tools/shared.d.ts +276 -0
  25. package/dist/commands/agent-tools/shared.js +94 -0
  26. package/dist/commands/agent-tools/shared.js.map +1 -0
  27. package/dist/commands/agent-tools.d.ts +5 -0
  28. package/dist/commands/agent-tools.js +11 -0
  29. package/dist/commands/agent-tools.js.map +1 -0
  30. package/dist/commands/auth.d.ts +14 -0
  31. package/dist/commands/auth.js +161 -0
  32. package/dist/commands/auth.js.map +1 -0
  33. package/dist/commands/completion.d.ts +4 -0
  34. package/dist/commands/completion.js +50 -0
  35. package/dist/commands/completion.js.map +1 -0
  36. package/dist/commands/config-sources.d.ts +22 -0
  37. package/dist/commands/config-sources.js +46 -0
  38. package/dist/commands/config-sources.js.map +1 -0
  39. package/dist/commands/config-wizard.d.ts +9 -0
  40. package/dist/commands/config-wizard.js +332 -0
  41. package/dist/commands/config-wizard.js.map +1 -0
  42. package/dist/commands/orgs.d.ts +11 -0
  43. package/dist/commands/orgs.js +179 -0
  44. package/dist/commands/orgs.js.map +1 -0
  45. package/dist/commands/skill-dir.d.ts +18 -0
  46. package/dist/commands/skill-dir.js +97 -0
  47. package/dist/commands/skill-dir.js.map +1 -0
  48. package/dist/commands/token-notice.d.ts +4 -0
  49. package/dist/commands/token-notice.js +13 -0
  50. package/dist/commands/token-notice.js.map +1 -0
  51. package/dist/commands/whoami.d.ts +8 -0
  52. package/dist/commands/whoami.js +38 -0
  53. package/dist/commands/whoami.js.map +1 -0
  54. package/dist/commands/wizards.d.ts +4 -0
  55. package/dist/commands/wizards.js +210 -0
  56. package/dist/commands/wizards.js.map +1 -0
  57. package/dist/completion/bash.d.ts +3 -0
  58. package/dist/completion/bash.js +60 -0
  59. package/dist/completion/bash.js.map +1 -0
  60. package/dist/completion/files.d.ts +33 -0
  61. package/dist/completion/files.js +171 -0
  62. package/dist/completion/files.js.map +1 -0
  63. package/dist/completion/powershell.d.ts +9 -0
  64. package/dist/completion/powershell.js +83 -0
  65. package/dist/completion/powershell.js.map +1 -0
  66. package/dist/completion/tree.d.ts +25 -0
  67. package/dist/completion/tree.js +53 -0
  68. package/dist/completion/tree.js.map +1 -0
  69. package/dist/completion/zsh.d.ts +3 -0
  70. package/dist/completion/zsh.js +76 -0
  71. package/dist/completion/zsh.js.map +1 -0
  72. package/dist/config/auth.d.ts +26 -0
  73. package/dist/config/auth.js +223 -0
  74. package/dist/config/auth.js.map +1 -0
  75. package/dist/config/link.d.ts +16 -0
  76. package/dist/config/link.js +74 -0
  77. package/dist/config/link.js.map +1 -0
  78. package/dist/config/paths.d.ts +3 -0
  79. package/dist/config/paths.js +20 -0
  80. package/dist/config/paths.js.map +1 -0
  81. package/dist/config/settings.d.ts +8 -0
  82. package/dist/config/settings.js +24 -0
  83. package/dist/config/settings.js.map +1 -0
  84. package/dist/confirm.d.ts +35 -0
  85. package/dist/confirm.js +51 -0
  86. package/dist/confirm.js.map +1 -0
  87. package/dist/context.d.ts +27 -0
  88. package/dist/context.js +15 -0
  89. package/dist/context.js.map +1 -0
  90. package/dist/errors.d.ts +54 -0
  91. package/dist/errors.js +184 -0
  92. package/dist/errors.js.map +1 -0
  93. package/dist/generated/commands.d.ts +47 -0
  94. package/dist/generated/commands.js +52 -0
  95. package/dist/generated/commands.js.map +1 -0
  96. package/dist/generated/schemas.d.ts +5 -0
  97. package/dist/generated/schemas.js +18 -0
  98. package/dist/generated/schemas.js.map +1 -0
  99. package/dist/invocation.d.ts +64 -0
  100. package/dist/invocation.js +325 -0
  101. package/dist/invocation.js.map +1 -0
  102. package/dist/mode.d.ts +17 -0
  103. package/dist/mode.js +22 -0
  104. package/dist/mode.js.map +1 -0
  105. package/dist/operations/call.d.ts +6 -0
  106. package/dist/operations/call.js +14 -0
  107. package/dist/operations/call.js.map +1 -0
  108. package/dist/operations/extensions.d.ts +46 -0
  109. package/dist/operations/extensions.js +29 -0
  110. package/dist/operations/extensions.js.map +1 -0
  111. package/dist/operations/json-input.d.ts +7 -0
  112. package/dist/operations/json-input.js +50 -0
  113. package/dist/operations/json-input.js.map +1 -0
  114. package/dist/operations/params.d.ts +17 -0
  115. package/dist/operations/params.js +95 -0
  116. package/dist/operations/params.js.map +1 -0
  117. package/dist/operations/register.d.ts +10 -0
  118. package/dist/operations/register.js +102 -0
  119. package/dist/operations/register.js.map +1 -0
  120. package/dist/operations/run-operation.d.ts +8 -0
  121. package/dist/operations/run-operation.js +146 -0
  122. package/dist/operations/run-operation.js.map +1 -0
  123. package/dist/operations/schema-flag.d.ts +8 -0
  124. package/dist/operations/schema-flag.js +12 -0
  125. package/dist/operations/schema-flag.js.map +1 -0
  126. package/dist/operations/skeleton.d.ts +16 -0
  127. package/dist/operations/skeleton.js +116 -0
  128. package/dist/operations/skeleton.js.map +1 -0
  129. package/dist/operations/tables.d.ts +3 -0
  130. package/dist/operations/tables.js +52 -0
  131. package/dist/operations/tables.js.map +1 -0
  132. package/dist/operations.d.ts +5 -0
  133. package/dist/operations.js +7 -0
  134. package/dist/operations.js.map +1 -0
  135. package/dist/output.d.ts +22 -0
  136. package/dist/output.js +169 -0
  137. package/dist/output.js.map +1 -0
  138. package/dist/pickers.d.ts +51 -0
  139. package/dist/pickers.js +277 -0
  140. package/dist/pickers.js.map +1 -0
  141. package/dist/program.d.ts +31 -0
  142. package/dist/program.js +251 -0
  143. package/dist/program.js.map +1 -0
  144. package/dist/prompter.d.ts +54 -0
  145. package/dist/prompter.js +129 -0
  146. package/dist/prompter.js.map +1 -0
  147. package/dist/session.d.ts +45 -0
  148. package/dist/session.js +170 -0
  149. package/dist/session.js.map +1 -0
  150. package/dist/update-check.d.ts +4 -0
  151. package/dist/update-check.js +60 -0
  152. package/dist/update-check.js.map +1 -0
  153. package/docs/SKILL.md +108 -0
  154. package/docs/references/auth-and-organizations.md +72 -0
  155. package/docs/references/commands.md +186 -0
  156. package/docs/references/output-and-errors.md +87 -0
  157. package/package.json +39 -5
@@ -0,0 +1,18 @@
1
+ // GENERADO por scripts/generate-commands.mjs a partir de ../delta-sdk/contract/openapi.json. No editar a mano.
2
+ /** Por operación con body: el JSON Schema de lo que se manda y de la respuesta, con los `$ref` ya resueltos. */
3
+ export const OPERATION_SCHEMAS = {
4
+ "agents.create": { "body": { "additionalProperties": false, "properties": { "activate": { "description": "Whether to make the new version the active one. Requires config. Defaults to true.", "type": "boolean" }, "config": { "additionalProperties": false, "description": "Config of the first version. When omitted, no version is created.", "properties": { "$schema": { "description": "JSON Schema URL for editors. Accepted and ignored; never stored.", "type": "string" }, "attachments": { "additionalProperties": false, "description": "How the agent handles files sent by the user.", "properties": { "access": { "const": "inline", "default": "inline", "description": "How the model reads attachments. Only `inline` is supported.", "type": "string" }, "allow_reread": { "default": true, "description": "Whether the model can read an attachment again after the turn it arrived in.", "type": "boolean" }, "keep_in_history": { "default": false, "description": "Whether attachments stay in the history of later turns.", "type": "boolean" }, "max_tokens_per_attachment": { "default": 30000, "description": "Token limit for each attachment.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "max_tokens_per_message": { "default": 90000, "description": "Token limit for all the attachments of one message.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "type": "object" }, "history": { "additionalProperties": false, "description": "How much of the conversation is sent to the model on each turn.", "properties": { "exchanges": { "default": 5, "description": "How many previous user/agent exchanges are sent to the model (1 to 12).", "maximum": 12, "minimum": 1, "type": "integer" }, "reasoning": { "description": "Whether past reasoning is sent back to the model.", "type": "boolean" }, "tool_calls": { "anyOf": [{ "additionalProperties": false, "description": "Tool calls are not kept in the history.", "properties": { "mode": { "const": "off", "description": "Tool calls are not kept.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": false, "description": "Tool calls of every exchange in the history are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "all", "description": "Keep the tool calls of every exchange.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": false, "description": "Only tool calls of the latest exchanges are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "recent", "description": "Keep the tool calls of the latest exchanges only.", "type": "string" }, "turns": { "description": "How many of the latest exchanges keep their tool calls.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": ["mode", "turns"], "type": "object" }], "default": { "mode": "off" }, "description": "Which tool calls are kept in the history. Defaults to `off`." } }, "type": "object" }, "knowledge": { "additionalProperties": false, "description": "Knowledge the agent can search to answer.", "properties": { "mode": { "description": "How the knowledge is searched. Only `vector` is supported.", "enum": ["vector"], "type": "string" }, "project_ids": { "description": "Knowledge projects the agent can search. Each id comes from `laburen knowledge projects list`.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "model": { "additionalProperties": false, "description": "The model the agent runs on.", "properties": { "id": { "description": "Model id. Comes from `laburen models list` (GET /models).", "pattern": "\\S", "type": "string" }, "reasoning_effort": { "description": "How much the model reasons before answering; must be one of the model's reasoning levels from GET /models. When omitted, the model default applies.", "enum": ["off", "low", "medium", "high", "max"], "type": "string" } }, "required": ["id"], "type": "object" }, "prompt": { "description": "System prompt, as a list of blocks that are joined in order.", "items": { "additionalProperties": false, "description": "A prompt block.", "properties": { "content": { "description": "Text of the block.", "type": "string" }, "type": { "const": "text", "description": "Block type. Only `text` is supported.", "type": "string" } }, "required": ["type", "content"], "type": "object" }, "type": "array" }, "tools": { "description": "Tools the model can call. Each non-http tool type at most once; thinking only when the model does not reason (see GET /models reasoning) or reasoning_effort is off.", "items": { "anyOf": [{ "additionalProperties": false, "description": "Calls an HTTP endpoint.", "properties": { "body": { "description": "Fields of the request body. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"city\", \"value\": \"Madrid\", \"description\": \"City to look up\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "description": { "description": "Tells the model when to use the tool.", "type": "string" }, "headers": { "description": "Headers sent on every call. Each item is an object `{ key, value, description? }`, not a string; for example `[{ \"key\": \"Authorization\", \"value\": \"Bearer abc\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "method": { "description": "HTTP method. Defaults to GET.", "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"], "type": "string" }, "name": { "description": "Name the model sees for the tool.", "type": "string" }, "path_variables": { "description": "Values for the `{name}` placeholders of the url. Each item is an object `{ key, value, description? }` where `key` is the placeholder name; for example `[{ \"key\": \"id\", \"value\": \"123\", \"description\": \"Order id\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "query_parameters": { "description": "Query parameters of the request. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"page\", \"value\": \"1\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "type": { "const": "http", "description": "Tool type: `http`.", "type": "string" }, "url": { "description": "URL the tool calls. Path variables are written as `{name}`.", "type": "string" }, "with_approval": { "description": "Whether a person must approve each call.", "type": "boolean" } }, "required": ["type", "url"], "type": "object" }, { "additionalProperties": false, "description": "Lets the model write down its reasoning before answering. Only for models that do not reason.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "instructions": { "description": "Extra instructions for how the model should think.", "type": "string" }, "max_thoughts": { "description": "Maximum number of thoughts per turn.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "type": { "const": "thinking", "description": "Tool type: `thinking`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": false, "description": "Lets the model send files to the user.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "send_files", "description": "Tool type: `send_files`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": false, "description": "Lets the model hand the conversation to a person.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "request_human", "description": "Tool type: `request_human`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }] }, "type": "array" } }, "required": ["model"], "type": "object" }, "description": { "default": "", "description": "What the agent is for. Defaults to an empty string.", "type": "string" }, "harness_type": { "const": "mastra", "description": "Runtime of the agent. Only `mastra` can be created through this API.", "type": "string" }, "mcp_connections": { "description": "MCP connections to assign. Requires config. Each connection_id comes from `laburen mcp connections create` or `mcp connections list`.", "items": { "additionalProperties": false, "description": "An MCP connection to assign to the agent.", "properties": { "connection_id": { "description": "Id of the MCP connection to assign.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "tools": { "description": "Names of the connection tools the agent can use; when omitted or empty, all of them. Use the `name` field from `mcp connections tools list` (not `agent_tool_name`). Validated at save: an unknown name is rejected and lists the valid ones.", "items": { "type": "string" }, "type": "array" }, "version_id": { "description": "Version of the connection to pin. Used when the strategy is `pin`.", "type": "string" } }, "required": ["connection_id"], "type": "object" }, "type": "array" }, "name": { "description": "Name of the agent.", "minLength": 1, "type": "string" }, "skills": { "description": "Skills to assign. Requires config. Each skill_id comes from `laburen skills create` or `skills list`.", "items": { "additionalProperties": false, "description": "A skill to assign to the agent.", "properties": { "skill_id": { "description": "Id of the skill to assign.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "version_id": { "description": "Version of the skill to pin. Used when the strategy is `pin`.", "type": "string" } }, "required": ["skill_id"], "type": "object" }, "type": "array" } }, "required": ["harness_type", "name"], "type": "object" }, "response": { "properties": { "active_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the version that is running; `null` when none is active." }, "created_at": { "description": "When the agent was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "description": { "description": "What the agent is for.", "type": "string" }, "harness_type": { "description": "Runtime the agent runs on. Agents created through this API are `mastra`.", "enum": ["legacy", "mastra"], "type": "string" }, "id": { "description": "Id of the agent.", "type": "string" }, "name": { "description": "Name of the agent.", "type": "string" }, "type": { "const": "agent", "description": "Object type, always `agent`.", "type": "string" }, "updated_at": { "description": "When the agent was last changed (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "version": { "anyOf": [{ "properties": { "agent_id": { "description": "Id of the agent this version belongs to.", "type": "string" }, "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Config paths that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "config": { "additionalProperties": {}, "description": "Config of an agent version.", "properties": { "attachments": { "additionalProperties": {}, "description": "How the agent handles files sent by the user.", "properties": { "access": { "const": "inline", "default": "inline", "description": "How the model reads attachments. Only `inline` is supported.", "type": "string" }, "allow_reread": { "default": true, "description": "Whether the model can read an attachment again after the turn it arrived in.", "type": "boolean" }, "keep_in_history": { "default": false, "description": "Whether attachments stay in the history of later turns.", "type": "boolean" }, "max_tokens_per_attachment": { "default": 30000, "description": "Token limit for each attachment.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "max_tokens_per_message": { "default": 90000, "description": "Token limit for all the attachments of one message.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "type": "object" }, "history": { "additionalProperties": {}, "description": "How much of the conversation is sent to the model on each turn.", "properties": { "exchanges": { "default": 5, "description": "How many previous user/agent exchanges are sent to the model (1 to 12).", "maximum": 12, "minimum": 1, "type": "integer" }, "reasoning": { "description": "Whether past reasoning is sent back to the model.", "type": "boolean" }, "tool_calls": { "anyOf": [{ "additionalProperties": {}, "description": "Tool calls are not kept in the history.", "properties": { "mode": { "const": "off", "description": "Tool calls are not kept.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": {}, "description": "Tool calls of every exchange in the history are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "all", "description": "Keep the tool calls of every exchange.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": {}, "description": "Only tool calls of the latest exchanges are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "recent", "description": "Keep the tool calls of the latest exchanges only.", "type": "string" }, "turns": { "description": "How many of the latest exchanges keep their tool calls.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": ["mode", "turns"], "type": "object" }], "default": { "mode": "off" }, "description": "Which tool calls are kept in the history. Defaults to `off`." } }, "type": "object" }, "knowledge": { "additionalProperties": {}, "description": "Knowledge the agent can search to answer.", "properties": { "mode": { "description": "How the knowledge is searched. Only `vector` is supported.", "enum": ["vector"], "type": "string" }, "project_ids": { "description": "Knowledge projects the agent can search. Each id comes from `laburen knowledge projects list`.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "model": { "additionalProperties": {}, "description": "The model the agent runs on.", "properties": { "id": { "description": "Model id. Comes from `laburen models list` (GET /models).", "type": "string" }, "reasoning_effort": { "description": "How much the model reasons before answering; must be one of the model's reasoning levels from GET /models. When omitted, the model default applies.", "enum": ["off", "low", "medium", "high", "max"], "type": "string" } }, "required": ["id"], "type": "object" }, "prompt": { "description": "System prompt, as a list of blocks that are joined in order.", "items": {}, "type": "array" }, "tools": { "description": "Tools the model can call. Each non-http tool type at most once; thinking only when the model does not reason (see GET /models reasoning) or reasoning_effort is off.", "items": { "anyOf": [{ "additionalProperties": {}, "description": "Calls an HTTP endpoint.", "properties": { "body": { "description": "Fields of the request body. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"city\", \"value\": \"Madrid\", \"description\": \"City to look up\" }]`.", "items": {}, "type": "array" }, "description": { "description": "Tells the model when to use the tool.", "type": "string" }, "headers": { "description": "Headers sent on every call. Each item is an object `{ key, value, description? }`, not a string; for example `[{ \"key\": \"Authorization\", \"value\": \"Bearer abc\" }]`.", "items": {}, "type": "array" }, "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "method": { "description": "HTTP method. Defaults to GET.", "type": "string" }, "name": { "description": "Name the model sees for the tool." }, "path_variables": { "description": "Values for the `{name}` placeholders of the url. Each item is an object `{ key, value, description? }` where `key` is the placeholder name; for example `[{ \"key\": \"id\", \"value\": \"123\", \"description\": \"Order id\" }]`.", "items": {}, "type": "array" }, "query_parameters": { "description": "Query parameters of the request. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"page\", \"value\": \"1\" }]`.", "items": {}, "type": "array" }, "type": { "const": "http", "description": "Tool type: `http`.", "type": "string" }, "url": { "description": "URL the tool calls. Path variables are written as `{name}`.", "type": "string" }, "with_approval": { "description": "Whether a person must approve each call." } }, "required": ["type", "url"], "type": "object" }, { "additionalProperties": {}, "description": "Lets the model write down its reasoning before answering. Only for models that do not reason.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "instructions": { "description": "Extra instructions for how the model should think.", "type": "string" }, "max_thoughts": { "description": "Maximum number of thoughts per turn.", "type": "number" }, "type": { "const": "thinking", "description": "Tool type: `thinking`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": {}, "description": "Lets the model send files to the user.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "send_files", "description": "Tool type: `send_files`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": {}, "description": "Lets the model hand the conversation to a person.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "request_human", "description": "Tool type: `request_human`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }] }, "type": "array" } }, "type": "object" }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "harness_type": { "description": "Runtime the version runs on.", "enum": ["legacy", "mastra"], "type": "string" }, "id": { "description": "Id of the version.", "type": "string" }, "is_active": { "description": "Whether this is the version that is running.", "type": "boolean" }, "mcp_connections": { "description": "MCP connections assigned to this version.", "items": { "description": "An MCP connection assigned to the agent.", "properties": { "connection_id": { "description": "Id of the assigned MCP connection.", "type": "string" }, "pinned_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Version of the connection in use when the strategy is `pin`; `null` otherwise." }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "tools": { "description": "Server tool names of the connection the agent can use (the `name` field of `mcp connections tools list`); empty means all of them.", "items": { "type": "string" }, "type": "array" } }, "required": ["connection_id", "strategy", "pinned_version_id", "tools"], "type": "object" }, "type": "array" }, "skills": { "description": "Skills assigned to this version.", "items": { "description": "A skill assigned to the agent.", "properties": { "pinned_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Version of the skill in use when the strategy is `pin`; `null` otherwise." }, "skill_id": { "description": "Id of the assigned skill.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" } }, "required": ["skill_id", "strategy", "pinned_version_id"], "type": "object" }, "type": "array" }, "type": { "const": "agent_version", "description": "Object type, always `agent_version`.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "warnings": { "description": "Present only on the response of the call that created the version, and only when something was saved without verification.", "items": { "description": "Something that was saved without being verified.", "properties": { "code": { "const": "mcp_tools_unverified", "description": "`mcp_tools_unverified`: the MCP server could not be reached, so the tool names of this connection were saved without checking.", "type": "string" }, "connection_id": { "description": "Id of the MCP connection that could not be reached.", "type": "string" }, "message": { "description": "What could not be checked and how to check it.", "type": "string" } }, "required": ["code", "message", "connection_id"], "type": "object" }, "type": "array" } }, "required": ["type", "id", "agent_id", "version_number", "harness_type", "config", "skills", "mcp_connections", "changed_fields", "change_message", "created_by", "created_at", "is_active"], "type": "object" }, { "type": "null" }], "description": "The version this call created; `null` when it did not create one." } }, "required": ["type", "id", "name", "description", "harness_type", "active_version_id", "created_at", "updated_at", "version"], "type": "object" } },
5
+ "agents.update": { "body": { "additionalProperties": false, "properties": { "activate": { "description": "Whether to make the new version the active one. Only applies when a version is created. Defaults to false.", "type": "boolean" }, "base_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the version you based this change on. If it is not the latest version, the call fails with 409 `base_version_mismatch` and `details.latest_version_id`. Send `null` to say the resource has no versions yet; omit it to skip the check." }, "change_message": { "description": "Note stored with the new version. Used only when a version is created.", "type": "string" }, "config": { "additionalProperties": false, "description": "Changes to the config. Creates a new version.", "properties": { "$schema": { "description": "JSON Schema URL for editors. Accepted and ignored; never stored.", "type": "string" }, "attachments": { "anyOf": [{ "additionalProperties": false, "description": "How the agent handles files sent by the user.", "properties": { "access": { "const": "inline", "default": "inline", "description": "How the model reads attachments. Only `inline` is supported.", "type": "string" }, "allow_reread": { "default": true, "description": "Whether the model can read an attachment again after the turn it arrived in.", "type": "boolean" }, "keep_in_history": { "default": false, "description": "Whether attachments stay in the history of later turns.", "type": "boolean" }, "max_tokens_per_attachment": { "default": 30000, "description": "Token limit for each attachment.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "max_tokens_per_message": { "default": 90000, "description": "Token limit for all the attachments of one message.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "type": "object" }, { "type": "null" }], "description": "How the agent handles files sent by the user. `null` removes it." }, "history": { "anyOf": [{ "additionalProperties": false, "description": "How much of the conversation is sent to the model on each turn.", "properties": { "exchanges": { "default": 5, "description": "How many previous user/agent exchanges are sent to the model (1 to 12).", "maximum": 12, "minimum": 1, "type": "integer" }, "reasoning": { "description": "Whether past reasoning is sent back to the model.", "type": "boolean" }, "tool_calls": { "anyOf": [{ "additionalProperties": false, "description": "Tool calls are not kept in the history.", "properties": { "mode": { "const": "off", "description": "Tool calls are not kept.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": false, "description": "Tool calls of every exchange in the history are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "all", "description": "Keep the tool calls of every exchange.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": false, "description": "Only tool calls of the latest exchanges are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "recent", "description": "Keep the tool calls of the latest exchanges only.", "type": "string" }, "turns": { "description": "How many of the latest exchanges keep their tool calls.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": ["mode", "turns"], "type": "object" }], "default": { "mode": "off" }, "description": "Which tool calls are kept in the history. Defaults to `off`." } }, "type": "object" }, { "type": "null" }], "description": "How much of the conversation is sent to the model. `null` removes it." }, "knowledge": { "anyOf": [{ "additionalProperties": false, "description": "Knowledge the agent can search to answer.", "properties": { "mode": { "description": "How the knowledge is searched. Only `vector` is supported.", "enum": ["vector"], "type": "string" }, "project_ids": { "description": "Knowledge projects the agent can search. Each id comes from `laburen knowledge projects list`.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, { "type": "null" }], "description": "Knowledge the agent can search. `null` removes it." }, "model": { "additionalProperties": false, "description": "The model the agent runs on.", "properties": { "id": { "description": "Model id. Comes from `laburen models list` (GET /models).", "pattern": "\\S", "type": "string" }, "reasoning_effort": { "description": "How much the model reasons before answering; must be one of the model's reasoning levels from GET /models. When omitted, the model default applies.", "enum": ["off", "low", "medium", "high", "max"], "type": "string" } }, "required": ["id"], "type": "object" }, "prompt": { "anyOf": [{ "description": "System prompt, as a list of blocks that are joined in order.", "items": { "additionalProperties": false, "description": "A prompt block.", "properties": { "content": { "description": "Text of the block.", "type": "string" }, "type": { "const": "text", "description": "Block type. Only `text` is supported.", "type": "string" } }, "required": ["type", "content"], "type": "object" }, "type": "array" }, { "type": "null" }], "description": "System prompt, as a list of blocks. `null` removes it." }, "tools": { "anyOf": [{ "description": "Tools the model can call. Each non-http tool type at most once; thinking only when the model does not reason (see GET /models reasoning) or reasoning_effort is off.", "items": { "anyOf": [{ "additionalProperties": false, "description": "Calls an HTTP endpoint.", "properties": { "body": { "description": "Fields of the request body. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"city\", \"value\": \"Madrid\", \"description\": \"City to look up\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "description": { "description": "Tells the model when to use the tool.", "type": "string" }, "headers": { "description": "Headers sent on every call. Each item is an object `{ key, value, description? }`, not a string; for example `[{ \"key\": \"Authorization\", \"value\": \"Bearer abc\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "method": { "description": "HTTP method. Defaults to GET.", "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"], "type": "string" }, "name": { "description": "Name the model sees for the tool.", "type": "string" }, "path_variables": { "description": "Values for the `{name}` placeholders of the url. Each item is an object `{ key, value, description? }` where `key` is the placeholder name; for example `[{ \"key\": \"id\", \"value\": \"123\", \"description\": \"Order id\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "query_parameters": { "description": "Query parameters of the request. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"page\", \"value\": \"1\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "type": { "const": "http", "description": "Tool type: `http`.", "type": "string" }, "url": { "description": "URL the tool calls. Path variables are written as `{name}`.", "type": "string" }, "with_approval": { "description": "Whether a person must approve each call.", "type": "boolean" } }, "required": ["type", "url"], "type": "object" }, { "additionalProperties": false, "description": "Lets the model write down its reasoning before answering. Only for models that do not reason.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "instructions": { "description": "Extra instructions for how the model should think.", "type": "string" }, "max_thoughts": { "description": "Maximum number of thoughts per turn.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "type": { "const": "thinking", "description": "Tool type: `thinking`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": false, "description": "Lets the model send files to the user.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "send_files", "description": "Tool type: `send_files`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": false, "description": "Lets the model hand the conversation to a person.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "request_human", "description": "Tool type: `request_human`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }] }, "type": "array" }, { "type": "null" }], "description": "Tools the model can call. Each non-http tool type at most once; thinking only when the model does not reason (see GET /models reasoning) or reasoning_effort is off. `null` removes it." } }, "type": "object" }, "description": { "description": "New description of the agent.", "type": "string" }, "mcp_connections": { "description": "Replaces the assigned MCP connections. Creates a new version. Each connection_id comes from `laburen mcp connections create` or `mcp connections list`.", "items": { "additionalProperties": false, "description": "An MCP connection to assign to the agent.", "properties": { "connection_id": { "description": "Id of the MCP connection to assign.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "tools": { "description": "Names of the connection tools the agent can use; when omitted or empty, all of them. Use the `name` field from `mcp connections tools list` (not `agent_tool_name`). Validated at save: an unknown name is rejected and lists the valid ones.", "items": { "type": "string" }, "type": "array" }, "version_id": { "description": "Version of the connection to pin. Used when the strategy is `pin`.", "type": "string" } }, "required": ["connection_id"], "type": "object" }, "type": "array" }, "name": { "description": "New name of the agent.", "minLength": 1, "type": "string" }, "skills": { "description": "Replaces the assigned skills. Creates a new version. Each skill_id comes from `laburen skills create` or `skills list`.", "items": { "additionalProperties": false, "description": "A skill to assign to the agent.", "properties": { "skill_id": { "description": "Id of the skill to assign.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "version_id": { "description": "Version of the skill to pin. Used when the strategy is `pin`.", "type": "string" } }, "required": ["skill_id"], "type": "object" }, "type": "array" } }, "type": "object" }, "response": { "properties": { "active_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the version that is running; `null` when none is active." }, "created_at": { "description": "When the agent was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "description": { "description": "What the agent is for.", "type": "string" }, "harness_type": { "description": "Runtime the agent runs on. Agents created through this API are `mastra`.", "enum": ["legacy", "mastra"], "type": "string" }, "id": { "description": "Id of the agent.", "type": "string" }, "name": { "description": "Name of the agent.", "type": "string" }, "type": { "const": "agent", "description": "Object type, always `agent`.", "type": "string" }, "updated_at": { "description": "When the agent was last changed (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "version": { "anyOf": [{ "properties": { "agent_id": { "description": "Id of the agent this version belongs to.", "type": "string" }, "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Config paths that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "config": { "additionalProperties": {}, "description": "Config of an agent version.", "properties": { "attachments": { "additionalProperties": {}, "description": "How the agent handles files sent by the user.", "properties": { "access": { "const": "inline", "default": "inline", "description": "How the model reads attachments. Only `inline` is supported.", "type": "string" }, "allow_reread": { "default": true, "description": "Whether the model can read an attachment again after the turn it arrived in.", "type": "boolean" }, "keep_in_history": { "default": false, "description": "Whether attachments stay in the history of later turns.", "type": "boolean" }, "max_tokens_per_attachment": { "default": 30000, "description": "Token limit for each attachment.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "max_tokens_per_message": { "default": 90000, "description": "Token limit for all the attachments of one message.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "type": "object" }, "history": { "additionalProperties": {}, "description": "How much of the conversation is sent to the model on each turn.", "properties": { "exchanges": { "default": 5, "description": "How many previous user/agent exchanges are sent to the model (1 to 12).", "maximum": 12, "minimum": 1, "type": "integer" }, "reasoning": { "description": "Whether past reasoning is sent back to the model.", "type": "boolean" }, "tool_calls": { "anyOf": [{ "additionalProperties": {}, "description": "Tool calls are not kept in the history.", "properties": { "mode": { "const": "off", "description": "Tool calls are not kept.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": {}, "description": "Tool calls of every exchange in the history are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "all", "description": "Keep the tool calls of every exchange.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": {}, "description": "Only tool calls of the latest exchanges are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "recent", "description": "Keep the tool calls of the latest exchanges only.", "type": "string" }, "turns": { "description": "How many of the latest exchanges keep their tool calls.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": ["mode", "turns"], "type": "object" }], "default": { "mode": "off" }, "description": "Which tool calls are kept in the history. Defaults to `off`." } }, "type": "object" }, "knowledge": { "additionalProperties": {}, "description": "Knowledge the agent can search to answer.", "properties": { "mode": { "description": "How the knowledge is searched. Only `vector` is supported.", "enum": ["vector"], "type": "string" }, "project_ids": { "description": "Knowledge projects the agent can search. Each id comes from `laburen knowledge projects list`.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "model": { "additionalProperties": {}, "description": "The model the agent runs on.", "properties": { "id": { "description": "Model id. Comes from `laburen models list` (GET /models).", "type": "string" }, "reasoning_effort": { "description": "How much the model reasons before answering; must be one of the model's reasoning levels from GET /models. When omitted, the model default applies.", "enum": ["off", "low", "medium", "high", "max"], "type": "string" } }, "required": ["id"], "type": "object" }, "prompt": { "description": "System prompt, as a list of blocks that are joined in order.", "items": {}, "type": "array" }, "tools": { "description": "Tools the model can call. Each non-http tool type at most once; thinking only when the model does not reason (see GET /models reasoning) or reasoning_effort is off.", "items": { "anyOf": [{ "additionalProperties": {}, "description": "Calls an HTTP endpoint.", "properties": { "body": { "description": "Fields of the request body. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"city\", \"value\": \"Madrid\", \"description\": \"City to look up\" }]`.", "items": {}, "type": "array" }, "description": { "description": "Tells the model when to use the tool.", "type": "string" }, "headers": { "description": "Headers sent on every call. Each item is an object `{ key, value, description? }`, not a string; for example `[{ \"key\": \"Authorization\", \"value\": \"Bearer abc\" }]`.", "items": {}, "type": "array" }, "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "method": { "description": "HTTP method. Defaults to GET.", "type": "string" }, "name": { "description": "Name the model sees for the tool." }, "path_variables": { "description": "Values for the `{name}` placeholders of the url. Each item is an object `{ key, value, description? }` where `key` is the placeholder name; for example `[{ \"key\": \"id\", \"value\": \"123\", \"description\": \"Order id\" }]`.", "items": {}, "type": "array" }, "query_parameters": { "description": "Query parameters of the request. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"page\", \"value\": \"1\" }]`.", "items": {}, "type": "array" }, "type": { "const": "http", "description": "Tool type: `http`.", "type": "string" }, "url": { "description": "URL the tool calls. Path variables are written as `{name}`.", "type": "string" }, "with_approval": { "description": "Whether a person must approve each call." } }, "required": ["type", "url"], "type": "object" }, { "additionalProperties": {}, "description": "Lets the model write down its reasoning before answering. Only for models that do not reason.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "instructions": { "description": "Extra instructions for how the model should think.", "type": "string" }, "max_thoughts": { "description": "Maximum number of thoughts per turn.", "type": "number" }, "type": { "const": "thinking", "description": "Tool type: `thinking`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": {}, "description": "Lets the model send files to the user.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "send_files", "description": "Tool type: `send_files`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": {}, "description": "Lets the model hand the conversation to a person.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "request_human", "description": "Tool type: `request_human`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }] }, "type": "array" } }, "type": "object" }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "harness_type": { "description": "Runtime the version runs on.", "enum": ["legacy", "mastra"], "type": "string" }, "id": { "description": "Id of the version.", "type": "string" }, "is_active": { "description": "Whether this is the version that is running.", "type": "boolean" }, "mcp_connections": { "description": "MCP connections assigned to this version.", "items": { "description": "An MCP connection assigned to the agent.", "properties": { "connection_id": { "description": "Id of the assigned MCP connection.", "type": "string" }, "pinned_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Version of the connection in use when the strategy is `pin`; `null` otherwise." }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "tools": { "description": "Server tool names of the connection the agent can use (the `name` field of `mcp connections tools list`); empty means all of them.", "items": { "type": "string" }, "type": "array" } }, "required": ["connection_id", "strategy", "pinned_version_id", "tools"], "type": "object" }, "type": "array" }, "skills": { "description": "Skills assigned to this version.", "items": { "description": "A skill assigned to the agent.", "properties": { "pinned_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Version of the skill in use when the strategy is `pin`; `null` otherwise." }, "skill_id": { "description": "Id of the assigned skill.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" } }, "required": ["skill_id", "strategy", "pinned_version_id"], "type": "object" }, "type": "array" }, "type": { "const": "agent_version", "description": "Object type, always `agent_version`.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "warnings": { "description": "Present only on the response of the call that created the version, and only when something was saved without verification.", "items": { "description": "Something that was saved without being verified.", "properties": { "code": { "const": "mcp_tools_unverified", "description": "`mcp_tools_unverified`: the MCP server could not be reached, so the tool names of this connection were saved without checking.", "type": "string" }, "connection_id": { "description": "Id of the MCP connection that could not be reached.", "type": "string" }, "message": { "description": "What could not be checked and how to check it.", "type": "string" } }, "required": ["code", "message", "connection_id"], "type": "object" }, "type": "array" } }, "required": ["type", "id", "agent_id", "version_number", "harness_type", "config", "skills", "mcp_connections", "changed_fields", "change_message", "created_by", "created_at", "is_active"], "type": "object" }, { "type": "null" }], "description": "The version this call created; `null` when it did not create one." } }, "required": ["type", "id", "name", "description", "harness_type", "active_version_id", "created_at", "updated_at", "version"], "type": "object" } },
6
+ "agents.versions.create": { "body": { "additionalProperties": false, "properties": { "base_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the version you based this change on. If it is not the latest version, the call fails with 409 `base_version_mismatch` and `details.latest_version_id`. Send `null` to say the resource has no versions yet; omit it to skip the check." }, "change_message": { "description": "Note stored with the version.", "type": "string" }, "config": { "additionalProperties": false, "description": "Config to create an agent version. `model` is required; omitted keys use their defaults.", "properties": { "$schema": { "description": "JSON Schema URL for editors. Accepted and ignored; never stored.", "type": "string" }, "attachments": { "additionalProperties": false, "description": "How the agent handles files sent by the user.", "properties": { "access": { "const": "inline", "default": "inline", "description": "How the model reads attachments. Only `inline` is supported.", "type": "string" }, "allow_reread": { "default": true, "description": "Whether the model can read an attachment again after the turn it arrived in.", "type": "boolean" }, "keep_in_history": { "default": false, "description": "Whether attachments stay in the history of later turns.", "type": "boolean" }, "max_tokens_per_attachment": { "default": 30000, "description": "Token limit for each attachment.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "max_tokens_per_message": { "default": 90000, "description": "Token limit for all the attachments of one message.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "type": "object" }, "history": { "additionalProperties": false, "description": "How much of the conversation is sent to the model on each turn.", "properties": { "exchanges": { "default": 5, "description": "How many previous user/agent exchanges are sent to the model (1 to 12).", "maximum": 12, "minimum": 1, "type": "integer" }, "reasoning": { "description": "Whether past reasoning is sent back to the model.", "type": "boolean" }, "tool_calls": { "anyOf": [{ "additionalProperties": false, "description": "Tool calls are not kept in the history.", "properties": { "mode": { "const": "off", "description": "Tool calls are not kept.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": false, "description": "Tool calls of every exchange in the history are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "all", "description": "Keep the tool calls of every exchange.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": false, "description": "Only tool calls of the latest exchanges are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "recent", "description": "Keep the tool calls of the latest exchanges only.", "type": "string" }, "turns": { "description": "How many of the latest exchanges keep their tool calls.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": ["mode", "turns"], "type": "object" }], "default": { "mode": "off" }, "description": "Which tool calls are kept in the history. Defaults to `off`." } }, "type": "object" }, "knowledge": { "additionalProperties": false, "description": "Knowledge the agent can search to answer.", "properties": { "mode": { "description": "How the knowledge is searched. Only `vector` is supported.", "enum": ["vector"], "type": "string" }, "project_ids": { "description": "Knowledge projects the agent can search. Each id comes from `laburen knowledge projects list`.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "model": { "additionalProperties": false, "description": "The model the agent runs on.", "properties": { "id": { "description": "Model id. Comes from `laburen models list` (GET /models).", "pattern": "\\S", "type": "string" }, "reasoning_effort": { "description": "How much the model reasons before answering; must be one of the model's reasoning levels from GET /models. When omitted, the model default applies.", "enum": ["off", "low", "medium", "high", "max"], "type": "string" } }, "required": ["id"], "type": "object" }, "prompt": { "description": "System prompt, as a list of blocks that are joined in order.", "items": { "additionalProperties": false, "description": "A prompt block.", "properties": { "content": { "description": "Text of the block.", "type": "string" }, "type": { "const": "text", "description": "Block type. Only `text` is supported.", "type": "string" } }, "required": ["type", "content"], "type": "object" }, "type": "array" }, "tools": { "description": "Tools the model can call. Each non-http tool type at most once; thinking only when the model does not reason (see GET /models reasoning) or reasoning_effort is off.", "items": { "anyOf": [{ "additionalProperties": false, "description": "Calls an HTTP endpoint.", "properties": { "body": { "description": "Fields of the request body. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"city\", \"value\": \"Madrid\", \"description\": \"City to look up\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "description": { "description": "Tells the model when to use the tool.", "type": "string" }, "headers": { "description": "Headers sent on every call. Each item is an object `{ key, value, description? }`, not a string; for example `[{ \"key\": \"Authorization\", \"value\": \"Bearer abc\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "method": { "description": "HTTP method. Defaults to GET.", "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"], "type": "string" }, "name": { "description": "Name the model sees for the tool.", "type": "string" }, "path_variables": { "description": "Values for the `{name}` placeholders of the url. Each item is an object `{ key, value, description? }` where `key` is the placeholder name; for example `[{ \"key\": \"id\", \"value\": \"123\", \"description\": \"Order id\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "query_parameters": { "description": "Query parameters of the request. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"page\", \"value\": \"1\" }]`.", "items": { "additionalProperties": false, "description": "A header, body field, query parameter or path variable of an http tool.", "properties": { "accepted_values": { "description": "Values the model may choose from.", "items": { "type": "string" }, "type": "array" }, "description": { "description": "Tells the model what to put in this field.", "type": "string" }, "is_user_provided": { "description": "Whether the model fills this value on each call instead of a fixed one.", "type": "boolean" }, "key": { "description": "Name of the header, body field, query parameter or path variable.", "type": "string" }, "required": { "description": "Whether the model must provide this value.", "type": "boolean" }, "type": { "description": "Type of the value the model provides.", "type": "string" }, "value": { "description": "Fixed value sent on every call." } }, "required": ["key"], "type": "object" }, "type": "array" }, "type": { "const": "http", "description": "Tool type: `http`.", "type": "string" }, "url": { "description": "URL the tool calls. Path variables are written as `{name}`.", "type": "string" }, "with_approval": { "description": "Whether a person must approve each call.", "type": "boolean" } }, "required": ["type", "url"], "type": "object" }, { "additionalProperties": false, "description": "Lets the model write down its reasoning before answering. Only for models that do not reason.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "instructions": { "description": "Extra instructions for how the model should think.", "type": "string" }, "max_thoughts": { "description": "Maximum number of thoughts per turn.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "type": { "const": "thinking", "description": "Tool type: `thinking`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": false, "description": "Lets the model send files to the user.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "send_files", "description": "Tool type: `send_files`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": false, "description": "Lets the model hand the conversation to a person.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "request_human", "description": "Tool type: `request_human`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }] }, "type": "array" } }, "required": ["model"], "type": "object" }, "mcp_connections": { "description": "MCP connections to assign. Each connection_id comes from `laburen mcp connections create` or `mcp connections list`.", "items": { "additionalProperties": false, "description": "An MCP connection to assign to the agent.", "properties": { "connection_id": { "description": "Id of the MCP connection to assign.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "tools": { "description": "Names of the connection tools the agent can use; when omitted or empty, all of them. Use the `name` field from `mcp connections tools list` (not `agent_tool_name`). Validated at save: an unknown name is rejected and lists the valid ones.", "items": { "type": "string" }, "type": "array" }, "version_id": { "description": "Version of the connection to pin. Used when the strategy is `pin`.", "type": "string" } }, "required": ["connection_id"], "type": "object" }, "type": "array" }, "skills": { "description": "Skills to assign. Each skill_id comes from `laburen skills create` or `skills list`.", "items": { "additionalProperties": false, "description": "A skill to assign to the agent.", "properties": { "skill_id": { "description": "Id of the skill to assign.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "version_id": { "description": "Version of the skill to pin. Used when the strategy is `pin`.", "type": "string" } }, "required": ["skill_id"], "type": "object" }, "type": "array" } }, "required": ["config"], "type": "object" }, "response": { "properties": { "agent_id": { "description": "Id of the agent this version belongs to.", "type": "string" }, "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Config paths that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "config": { "additionalProperties": {}, "description": "Config of an agent version.", "properties": { "attachments": { "additionalProperties": {}, "description": "How the agent handles files sent by the user.", "properties": { "access": { "const": "inline", "default": "inline", "description": "How the model reads attachments. Only `inline` is supported.", "type": "string" }, "allow_reread": { "default": true, "description": "Whether the model can read an attachment again after the turn it arrived in.", "type": "boolean" }, "keep_in_history": { "default": false, "description": "Whether attachments stay in the history of later turns.", "type": "boolean" }, "max_tokens_per_attachment": { "default": 30000, "description": "Token limit for each attachment.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "max_tokens_per_message": { "default": 90000, "description": "Token limit for all the attachments of one message.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "type": "object" }, "history": { "additionalProperties": {}, "description": "How much of the conversation is sent to the model on each turn.", "properties": { "exchanges": { "default": 5, "description": "How many previous user/agent exchanges are sent to the model (1 to 12).", "maximum": 12, "minimum": 1, "type": "integer" }, "reasoning": { "description": "Whether past reasoning is sent back to the model.", "type": "boolean" }, "tool_calls": { "anyOf": [{ "additionalProperties": {}, "description": "Tool calls are not kept in the history.", "properties": { "mode": { "const": "off", "description": "Tool calls are not kept.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": {}, "description": "Tool calls of every exchange in the history are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "all", "description": "Keep the tool calls of every exchange.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": {}, "description": "Only tool calls of the latest exchanges are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "recent", "description": "Keep the tool calls of the latest exchanges only.", "type": "string" }, "turns": { "description": "How many of the latest exchanges keep their tool calls.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": ["mode", "turns"], "type": "object" }], "default": { "mode": "off" }, "description": "Which tool calls are kept in the history. Defaults to `off`." } }, "type": "object" }, "knowledge": { "additionalProperties": {}, "description": "Knowledge the agent can search to answer.", "properties": { "mode": { "description": "How the knowledge is searched. Only `vector` is supported.", "enum": ["vector"], "type": "string" }, "project_ids": { "description": "Knowledge projects the agent can search. Each id comes from `laburen knowledge projects list`.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "model": { "additionalProperties": {}, "description": "The model the agent runs on.", "properties": { "id": { "description": "Model id. Comes from `laburen models list` (GET /models).", "type": "string" }, "reasoning_effort": { "description": "How much the model reasons before answering; must be one of the model's reasoning levels from GET /models. When omitted, the model default applies.", "enum": ["off", "low", "medium", "high", "max"], "type": "string" } }, "required": ["id"], "type": "object" }, "prompt": { "description": "System prompt, as a list of blocks that are joined in order.", "items": {}, "type": "array" }, "tools": { "description": "Tools the model can call. Each non-http tool type at most once; thinking only when the model does not reason (see GET /models reasoning) or reasoning_effort is off.", "items": { "anyOf": [{ "additionalProperties": {}, "description": "Calls an HTTP endpoint.", "properties": { "body": { "description": "Fields of the request body. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"city\", \"value\": \"Madrid\", \"description\": \"City to look up\" }]`.", "items": {}, "type": "array" }, "description": { "description": "Tells the model when to use the tool.", "type": "string" }, "headers": { "description": "Headers sent on every call. Each item is an object `{ key, value, description? }`, not a string; for example `[{ \"key\": \"Authorization\", \"value\": \"Bearer abc\" }]`.", "items": {}, "type": "array" }, "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "method": { "description": "HTTP method. Defaults to GET.", "type": "string" }, "name": { "description": "Name the model sees for the tool." }, "path_variables": { "description": "Values for the `{name}` placeholders of the url. Each item is an object `{ key, value, description? }` where `key` is the placeholder name; for example `[{ \"key\": \"id\", \"value\": \"123\", \"description\": \"Order id\" }]`.", "items": {}, "type": "array" }, "query_parameters": { "description": "Query parameters of the request. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"page\", \"value\": \"1\" }]`.", "items": {}, "type": "array" }, "type": { "const": "http", "description": "Tool type: `http`.", "type": "string" }, "url": { "description": "URL the tool calls. Path variables are written as `{name}`.", "type": "string" }, "with_approval": { "description": "Whether a person must approve each call." } }, "required": ["type", "url"], "type": "object" }, { "additionalProperties": {}, "description": "Lets the model write down its reasoning before answering. Only for models that do not reason.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "instructions": { "description": "Extra instructions for how the model should think.", "type": "string" }, "max_thoughts": { "description": "Maximum number of thoughts per turn.", "type": "number" }, "type": { "const": "thinking", "description": "Tool type: `thinking`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": {}, "description": "Lets the model send files to the user.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "send_files", "description": "Tool type: `send_files`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": {}, "description": "Lets the model hand the conversation to a person.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "request_human", "description": "Tool type: `request_human`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }] }, "type": "array" } }, "type": "object" }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "harness_type": { "description": "Runtime the version runs on.", "enum": ["legacy", "mastra"], "type": "string" }, "id": { "description": "Id of the version.", "type": "string" }, "is_active": { "description": "Whether this is the version that is running.", "type": "boolean" }, "mcp_connections": { "description": "MCP connections assigned to this version.", "items": { "description": "An MCP connection assigned to the agent.", "properties": { "connection_id": { "description": "Id of the assigned MCP connection.", "type": "string" }, "pinned_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Version of the connection in use when the strategy is `pin`; `null` otherwise." }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "tools": { "description": "Server tool names of the connection the agent can use (the `name` field of `mcp connections tools list`); empty means all of them.", "items": { "type": "string" }, "type": "array" } }, "required": ["connection_id", "strategy", "pinned_version_id", "tools"], "type": "object" }, "type": "array" }, "skills": { "description": "Skills assigned to this version.", "items": { "description": "A skill assigned to the agent.", "properties": { "pinned_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Version of the skill in use when the strategy is `pin`; `null` otherwise." }, "skill_id": { "description": "Id of the assigned skill.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" } }, "required": ["skill_id", "strategy", "pinned_version_id"], "type": "object" }, "type": "array" }, "type": { "const": "agent_version", "description": "Object type, always `agent_version`.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "warnings": { "description": "Present only on the response of the call that created the version, and only when something was saved without verification.", "items": { "description": "Something that was saved without being verified.", "properties": { "code": { "const": "mcp_tools_unverified", "description": "`mcp_tools_unverified`: the MCP server could not be reached, so the tool names of this connection were saved without checking.", "type": "string" }, "connection_id": { "description": "Id of the MCP connection that could not be reached.", "type": "string" }, "message": { "description": "What could not be checked and how to check it.", "type": "string" } }, "required": ["code", "message", "connection_id"], "type": "object" }, "type": "array" } }, "required": ["type", "id", "agent_id", "version_number", "harness_type", "config", "skills", "mcp_connections", "changed_fields", "change_message", "created_by", "created_at", "is_active"], "type": "object" } },
7
+ "agents.versions.restore": { "body": { "additionalProperties": false, "properties": { "activate": { "default": true, "description": "Whether to make the restored copy the active version. Defaults to true.", "type": "boolean" } }, "type": "object" }, "response": { "properties": { "agent_id": { "description": "Id of the agent this version belongs to.", "type": "string" }, "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Config paths that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "config": { "additionalProperties": {}, "description": "Config of an agent version.", "properties": { "attachments": { "additionalProperties": {}, "description": "How the agent handles files sent by the user.", "properties": { "access": { "const": "inline", "default": "inline", "description": "How the model reads attachments. Only `inline` is supported.", "type": "string" }, "allow_reread": { "default": true, "description": "Whether the model can read an attachment again after the turn it arrived in.", "type": "boolean" }, "keep_in_history": { "default": false, "description": "Whether attachments stay in the history of later turns.", "type": "boolean" }, "max_tokens_per_attachment": { "default": 30000, "description": "Token limit for each attachment.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "max_tokens_per_message": { "default": 90000, "description": "Token limit for all the attachments of one message.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "type": "object" }, "history": { "additionalProperties": {}, "description": "How much of the conversation is sent to the model on each turn.", "properties": { "exchanges": { "default": 5, "description": "How many previous user/agent exchanges are sent to the model (1 to 12).", "maximum": 12, "minimum": 1, "type": "integer" }, "reasoning": { "description": "Whether past reasoning is sent back to the model.", "type": "boolean" }, "tool_calls": { "anyOf": [{ "additionalProperties": {}, "description": "Tool calls are not kept in the history.", "properties": { "mode": { "const": "off", "description": "Tool calls are not kept.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": {}, "description": "Tool calls of every exchange in the history are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "all", "description": "Keep the tool calls of every exchange.", "type": "string" } }, "required": ["mode"], "type": "object" }, { "additionalProperties": {}, "description": "Only tool calls of the latest exchanges are kept.", "properties": { "exclude_tools": { "description": "Ids of tools whose calls are left out of the history.", "items": { "type": "string" }, "type": "array" }, "mode": { "const": "recent", "description": "Keep the tool calls of the latest exchanges only.", "type": "string" }, "turns": { "description": "How many of the latest exchanges keep their tool calls.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": ["mode", "turns"], "type": "object" }], "default": { "mode": "off" }, "description": "Which tool calls are kept in the history. Defaults to `off`." } }, "type": "object" }, "knowledge": { "additionalProperties": {}, "description": "Knowledge the agent can search to answer.", "properties": { "mode": { "description": "How the knowledge is searched. Only `vector` is supported.", "enum": ["vector"], "type": "string" }, "project_ids": { "description": "Knowledge projects the agent can search. Each id comes from `laburen knowledge projects list`.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "model": { "additionalProperties": {}, "description": "The model the agent runs on.", "properties": { "id": { "description": "Model id. Comes from `laburen models list` (GET /models).", "type": "string" }, "reasoning_effort": { "description": "How much the model reasons before answering; must be one of the model's reasoning levels from GET /models. When omitted, the model default applies.", "enum": ["off", "low", "medium", "high", "max"], "type": "string" } }, "required": ["id"], "type": "object" }, "prompt": { "description": "System prompt, as a list of blocks that are joined in order.", "items": {}, "type": "array" }, "tools": { "description": "Tools the model can call. Each non-http tool type at most once; thinking only when the model does not reason (see GET /models reasoning) or reasoning_effort is off.", "items": { "anyOf": [{ "additionalProperties": {}, "description": "Calls an HTTP endpoint.", "properties": { "body": { "description": "Fields of the request body. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"city\", \"value\": \"Madrid\", \"description\": \"City to look up\" }]`.", "items": {}, "type": "array" }, "description": { "description": "Tells the model when to use the tool.", "type": "string" }, "headers": { "description": "Headers sent on every call. Each item is an object `{ key, value, description? }`, not a string; for example `[{ \"key\": \"Authorization\", \"value\": \"Bearer abc\" }]`.", "items": {}, "type": "array" }, "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "method": { "description": "HTTP method. Defaults to GET.", "type": "string" }, "name": { "description": "Name the model sees for the tool." }, "path_variables": { "description": "Values for the `{name}` placeholders of the url. Each item is an object `{ key, value, description? }` where `key` is the placeholder name; for example `[{ \"key\": \"id\", \"value\": \"123\", \"description\": \"Order id\" }]`.", "items": {}, "type": "array" }, "query_parameters": { "description": "Query parameters of the request. Each item is an object `{ key, value, description? }`; for example `[{ \"key\": \"page\", \"value\": \"1\" }]`.", "items": {}, "type": "array" }, "type": { "const": "http", "description": "Tool type: `http`.", "type": "string" }, "url": { "description": "URL the tool calls. Path variables are written as `{name}`.", "type": "string" }, "with_approval": { "description": "Whether a person must approve each call." } }, "required": ["type", "url"], "type": "object" }, { "additionalProperties": {}, "description": "Lets the model write down its reasoning before answering. Only for models that do not reason.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "instructions": { "description": "Extra instructions for how the model should think.", "type": "string" }, "max_thoughts": { "description": "Maximum number of thoughts per turn.", "type": "number" }, "type": { "const": "thinking", "description": "Tool type: `thinking`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": {}, "description": "Lets the model send files to the user.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "send_files", "description": "Tool type: `send_files`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }, { "additionalProperties": {}, "description": "Lets the model hand the conversation to a person.", "properties": { "id": { "description": "Assigned by the server when omitted; use it to edit or remove the tool (agents tools remove <agent_id> <tool_id>). Must be unique among the tools.", "type": "string" }, "type": { "const": "request_human", "description": "Tool type: `request_human`.", "type": "string" } }, "required": ["type"], "type": "object", "x-single": true }] }, "type": "array" } }, "type": "object" }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "harness_type": { "description": "Runtime the version runs on.", "enum": ["legacy", "mastra"], "type": "string" }, "id": { "description": "Id of the version.", "type": "string" }, "is_active": { "description": "Whether this is the version that is running.", "type": "boolean" }, "mcp_connections": { "description": "MCP connections assigned to this version.", "items": { "description": "An MCP connection assigned to the agent.", "properties": { "connection_id": { "description": "Id of the assigned MCP connection.", "type": "string" }, "pinned_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Version of the connection in use when the strategy is `pin`; `null` otherwise." }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" }, "tools": { "description": "Server tool names of the connection the agent can use (the `name` field of `mcp connections tools list`); empty means all of them.", "items": { "type": "string" }, "type": "array" } }, "required": ["connection_id", "strategy", "pinned_version_id", "tools"], "type": "object" }, "type": "array" }, "skills": { "description": "Skills assigned to this version.", "items": { "description": "A skill assigned to the agent.", "properties": { "pinned_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Version of the skill in use when the strategy is `pin`; `null` otherwise." }, "skill_id": { "description": "Id of the assigned skill.", "type": "string" }, "strategy": { "description": "`pin` keeps a fixed version; `latest` follows the active version.", "enum": ["pin", "latest"], "type": "string" } }, "required": ["skill_id", "strategy", "pinned_version_id"], "type": "object" }, "type": "array" }, "type": { "const": "agent_version", "description": "Object type, always `agent_version`.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "warnings": { "description": "Present only on the response of the call that created the version, and only when something was saved without verification.", "items": { "description": "Something that was saved without being verified.", "properties": { "code": { "const": "mcp_tools_unverified", "description": "`mcp_tools_unverified`: the MCP server could not be reached, so the tool names of this connection were saved without checking.", "type": "string" }, "connection_id": { "description": "Id of the MCP connection that could not be reached.", "type": "string" }, "message": { "description": "What could not be checked and how to check it.", "type": "string" } }, "required": ["code", "message", "connection_id"], "type": "object" }, "type": "array" } }, "required": ["type", "id", "agent_id", "version_number", "harness_type", "config", "skills", "mcp_connections", "changed_fields", "change_message", "created_by", "created_at", "is_active"], "type": "object" } },
8
+ "mcp.connections.create": { "body": { "additionalProperties": false, "properties": { "activate": { "description": "Whether to make the first version the active one.", "type": "boolean" }, "change_message": { "description": "Note stored with the first version.", "type": "string" }, "headers": { "additionalProperties": { "type": "string" }, "description": "Headers sent to the MCP server: name to value.", "propertyNames": { "type": "string" }, "type": "object" }, "name": { "description": "Name of the connection.", "minLength": 1, "type": "string" }, "url": { "description": "URL of the MCP server.", "minLength": 1, "type": "string" } }, "required": ["name", "url"], "type": "object" }, "response": { "properties": { "active_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the version in use; `null` when none is active." }, "created_at": { "description": "When the connection was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the connection.", "type": "string" }, "id": { "description": "Id of the connection.", "type": "string" }, "name": { "description": "Name of the connection.", "type": "string" }, "type": { "const": "mcp_connection", "description": "Object type, always `mcp_connection`.", "type": "string" }, "updated_at": { "description": "When the connection was last changed (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "version": { "anyOf": [{ "properties": { "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Fields that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "connection_id": { "description": "Id of the connection this version belongs to.", "type": "string" }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "headers": { "additionalProperties": { "type": "string" }, "description": "Headers sent to the server: name to value. Values are always returned as `[REDACTED]`.", "propertyNames": { "type": "string" }, "type": "object" }, "id": { "description": "Id of the version.", "type": "string" }, "is_active": { "description": "Whether this is the version in use.", "type": "boolean" }, "type": { "const": "mcp_connection_version", "description": "Object type, always `mcp_connection_version`.", "type": "string" }, "url": { "description": "URL of the MCP server. Always returned as `[REDACTED]` because it can carry secrets.", "type": "string" }, "url_host": { "description": "Host of the URL, to recognize the server without exposing the rest.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "required": ["type", "id", "connection_id", "version_number", "url", "url_host", "headers", "changed_fields", "change_message", "created_by", "created_at", "is_active"], "type": "object" }, { "type": "null" }], "description": "The version this call created; `null` when it did not create one." } }, "required": ["type", "id", "name", "active_version_id", "created_by", "created_at", "updated_at", "version"], "type": "object" } },
9
+ "mcp.connections.update": { "body": { "additionalProperties": false, "properties": { "name": { "description": "New name of the connection.", "minLength": 1, "type": "string" } }, "required": ["name"], "type": "object" }, "response": { "properties": { "active_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the version in use; `null` when none is active." }, "created_at": { "description": "When the connection was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the connection.", "type": "string" }, "id": { "description": "Id of the connection.", "type": "string" }, "name": { "description": "Name of the connection.", "type": "string" }, "type": { "const": "mcp_connection", "description": "Object type, always `mcp_connection`.", "type": "string" }, "updated_at": { "description": "When the connection was last changed (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" } }, "required": ["type", "id", "name", "active_version_id", "created_by", "created_at", "updated_at"], "type": "object" } },
10
+ "mcp.connections.versions.create": { "body": { "additionalProperties": false, "properties": { "base_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the version you based this change on. If it is not the latest version, the call fails with 409 `base_version_mismatch` and `details.latest_version_id`. Send `null` to say the resource has no versions yet; omit it to skip the check." }, "change_message": { "description": "Note stored with the version.", "type": "string" }, "headers": { "additionalProperties": { "type": "string" }, "description": "Headers sent to the MCP server: name to value.", "propertyNames": { "type": "string" }, "type": "object" }, "url": { "description": "URL of the MCP server.", "minLength": 1, "type": "string" } }, "required": ["url"], "type": "object" }, "response": { "properties": { "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Fields that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "connection_id": { "description": "Id of the connection this version belongs to.", "type": "string" }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "headers": { "additionalProperties": { "type": "string" }, "description": "Headers sent to the server: name to value. Values are always returned as `[REDACTED]`.", "propertyNames": { "type": "string" }, "type": "object" }, "id": { "description": "Id of the version.", "type": "string" }, "is_active": { "description": "Whether this is the version in use.", "type": "boolean" }, "type": { "const": "mcp_connection_version", "description": "Object type, always `mcp_connection_version`.", "type": "string" }, "url": { "description": "URL of the MCP server. Always returned as `[REDACTED]` because it can carry secrets.", "type": "string" }, "url_host": { "description": "Host of the URL, to recognize the server without exposing the rest.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "required": ["type", "id", "connection_id", "version_number", "url", "url_host", "headers", "changed_fields", "change_message", "created_by", "created_at", "is_active"], "type": "object" } },
11
+ "mcp.connections.versions.restore": { "body": { "additionalProperties": false, "properties": { "activate": { "default": true, "description": "Whether to make the restored copy the active version. Defaults to true.", "type": "boolean" } }, "type": "object" }, "response": { "properties": { "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Fields that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "connection_id": { "description": "Id of the connection this version belongs to.", "type": "string" }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "headers": { "additionalProperties": { "type": "string" }, "description": "Headers sent to the server: name to value. Values are always returned as `[REDACTED]`.", "propertyNames": { "type": "string" }, "type": "object" }, "id": { "description": "Id of the version.", "type": "string" }, "is_active": { "description": "Whether this is the version in use.", "type": "boolean" }, "type": { "const": "mcp_connection_version", "description": "Object type, always `mcp_connection_version`.", "type": "string" }, "url": { "description": "URL of the MCP server. Always returned as `[REDACTED]` because it can carry secrets.", "type": "string" }, "url_host": { "description": "Host of the URL, to recognize the server without exposing the rest.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "required": ["type", "id", "connection_id", "version_number", "url", "url_host", "headers", "changed_fields", "change_message", "created_by", "created_at", "is_active"], "type": "object" } },
12
+ "skills.create": { "body": { "additionalProperties": false, "properties": { "change_message": { "description": "Note stored with the first version.", "type": "string" }, "files": { "additionalProperties": { "type": "string" }, "description": "Files of the skill: path to content. `SKILL.md` is required.", "propertyNames": { "type": "string" }, "type": "object" }, "name": { "description": "Name of the skill.", "minLength": 1, "type": "string" } }, "required": ["name", "files"], "type": "object" }, "response": { "properties": { "active_version_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the version in use; `null` when none is active." }, "created_at": { "description": "When the skill was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the skill.", "type": "string" }, "id": { "description": "Id of the skill.", "type": "string" }, "name": { "description": "Name of the skill.", "type": "string" }, "status": { "description": "`draft` until a version is activated; `published` afterwards.", "enum": ["draft", "published"], "type": "string" }, "type": { "const": "skill", "description": "Object type, always `skill`.", "type": "string" }, "updated_at": { "description": "When the skill was last changed (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "version": { "properties": { "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Fields that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "compatibility": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Compatibility notes declared in SKILL.md; `null` when there are none." }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "description": { "description": "What the skill does and when to use it, from SKILL.md.", "type": "string" }, "files": { "description": "Paths of the files of the version, not counting SKILL.md.", "items": { "type": "string" }, "type": "array" }, "id": { "description": "Id of the version.", "type": "string" }, "instructions": { "description": "Body of SKILL.md: the instructions the model follows.", "type": "string" }, "is_active": { "description": "Whether this is the version in use.", "type": "boolean" }, "license": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "License declared in SKILL.md; `null` when there is none." }, "metadata": { "description": "Free-form metadata declared in SKILL.md; returned as it was written." }, "name": { "description": "Name of the skill, from SKILL.md.", "type": "string" }, "skill_id": { "description": "Id of the skill this version belongs to.", "type": "string" }, "type": { "const": "skill_version", "description": "Object type, always `skill_version`.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "required": ["type", "id", "skill_id", "version_number", "name", "description", "instructions", "license", "compatibility", "metadata", "files", "changed_fields", "change_message", "created_by", "created_at", "is_active"], "type": "object" }, "warnings": { "description": "Problems found while reading SKILL.md that did not stop the save.", "items": { "type": "string" }, "type": "array" } }, "required": ["type", "id", "name", "status", "active_version_id", "created_by", "created_at", "updated_at", "version", "warnings"], "type": "object" } },
13
+ "skills.versions.create": { "body": { "additionalProperties": false, "properties": { "change_message": { "description": "Note stored with the version.", "type": "string" }, "files": { "additionalProperties": { "type": "string" }, "description": "Files of the skill: path to content. `SKILL.md` is required.", "propertyNames": { "type": "string" }, "type": "object" } }, "required": ["files"], "type": "object" }, "response": { "properties": { "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Fields that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "compatibility": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Compatibility notes declared in SKILL.md; `null` when there are none." }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "description": { "description": "What the skill does and when to use it, from SKILL.md.", "type": "string" }, "files": { "description": "Paths of the files of the version, not counting SKILL.md.", "items": { "type": "string" }, "type": "array" }, "id": { "description": "Id of the version.", "type": "string" }, "instructions": { "description": "Body of SKILL.md: the instructions the model follows.", "type": "string" }, "is_active": { "description": "Whether this is the version in use.", "type": "boolean" }, "license": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "License declared in SKILL.md; `null` when there is none." }, "metadata": { "description": "Free-form metadata declared in SKILL.md; returned as it was written." }, "name": { "description": "Name of the skill, from SKILL.md.", "type": "string" }, "skill_id": { "description": "Id of the skill this version belongs to.", "type": "string" }, "type": { "const": "skill_version", "description": "Object type, always `skill_version`.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "warnings": { "description": "Problems found while reading SKILL.md that did not stop the save.", "items": { "type": "string" }, "type": "array" } }, "required": ["type", "id", "skill_id", "version_number", "name", "description", "instructions", "license", "compatibility", "metadata", "files", "changed_fields", "change_message", "created_by", "created_at", "is_active", "warnings"], "type": "object" } },
14
+ "skills.versions.restore": { "body": { "additionalProperties": false, "properties": { "activate": { "default": true, "description": "Whether to make the restored copy the active version. Defaults to true.", "type": "boolean" } }, "type": "object" }, "response": { "properties": { "change_message": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Note written when the version was created; `null` when there is none." }, "changed_fields": { "description": "Fields that changed compared with the previous version.", "items": { "type": "string" }, "type": "array" }, "compatibility": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Compatibility notes declared in SKILL.md; `null` when there are none." }, "created_at": { "description": "When the version was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the version.", "type": "string" }, "description": { "description": "What the skill does and when to use it, from SKILL.md.", "type": "string" }, "files": { "description": "Paths of the files of the version, not counting SKILL.md.", "items": { "type": "string" }, "type": "array" }, "id": { "description": "Id of the version.", "type": "string" }, "instructions": { "description": "Body of SKILL.md: the instructions the model follows.", "type": "string" }, "is_active": { "description": "Whether this is the version in use.", "type": "boolean" }, "license": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "License declared in SKILL.md; `null` when there is none." }, "metadata": { "description": "Free-form metadata declared in SKILL.md; returned as it was written." }, "name": { "description": "Name of the skill, from SKILL.md.", "type": "string" }, "skill_id": { "description": "Id of the skill this version belongs to.", "type": "string" }, "type": { "const": "skill_version", "description": "Object type, always `skill_version`.", "type": "string" }, "version_number": { "description": "Sequential number of the version, starting at 1.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "required": ["type", "id", "skill_id", "version_number", "name", "description", "instructions", "license", "compatibility", "metadata", "files", "changed_fields", "change_message", "created_by", "created_at", "is_active"], "type": "object" } },
15
+ "tokens.create": { "body": { "additionalProperties": false, "properties": { "all_organizations": { "description": "For a personal token: make it work in every organization you belong to. Then X-Laburen-Organization is required on each call.", "type": "boolean" }, "description": { "description": "What the token is used for (up to 500 characters).", "maxLength": 500, "type": "string" }, "expires_at": { "description": "When the token expires (RFC 3339). When omitted, it does not expire.", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "kind": { "description": "`personal` acts as you; `organization` acts as the organization and needs admin.", "enum": ["personal", "organization"], "type": "string" }, "name": { "description": "Name of the token (1 to 100 characters).", "maxLength": 100, "minLength": 1, "type": "string" }, "permissions": { "description": "Permissions to grant. They cannot exceed your own.", "items": { "description": "Permission level: `query`, `read`, `write` or `admin`.", "enum": ["query", "read", "write", "admin"], "type": "string" }, "type": "array" } }, "required": ["kind", "permissions", "name"], "type": "object" }, "response": { "properties": { "created_at": { "description": "When the token was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the token.", "type": "string" }, "description": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "What the token is used for; `null` when there is none." }, "expires_at": { "anyOf": [{ "description": "When the token expires (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" }], "description": "When the token expires (RFC 3339); `null` if it does not expire." }, "id": { "description": "Id of the token.", "type": "string" }, "kind": { "description": "`personal` acts as a user; `organization` acts as the organization itself.", "enum": ["personal", "organization"], "type": "string" }, "last_used_at": { "anyOf": [{ "description": "When the token was last used (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" }], "description": "When the token was last used (RFC 3339); `null` if it never was." }, "name": { "description": "Name of the token.", "type": "string" }, "organization_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the organization the token is limited to; `null` for a personal token of all organizations." }, "permissions": { "description": "Permissions the token grants.", "items": { "description": "Permission level: `query`, `read`, `write` or `admin`.", "enum": ["query", "read", "write", "admin"], "type": "string" }, "type": "array" }, "prefix": { "description": "First characters of the token value, to recognize it.", "type": "string" }, "revoked_at": { "anyOf": [{ "description": "When the token was revoked (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" }], "description": "When the token was revoked (RFC 3339); `null` if it is still valid." }, "suffix": { "description": "Last characters of the token value, to recognize it.", "type": "string" }, "type": { "const": "token", "description": "Object type, always `token`.", "type": "string" }, "user_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the user the token belongs to; `null` for an organization token." }, "value": { "description": "The token secret, returned once in this response. Store it now: it cannot be read again.", "type": "string" } }, "required": ["type", "id", "kind", "user_id", "organization_id", "permissions", "prefix", "suffix", "name", "description", "last_used_at", "expires_at", "revoked_at", "created_by", "created_at", "value"], "type": "object" } },
16
+ "tokens.update": { "body": { "additionalProperties": false, "properties": { "description": { "anyOf": [{ "description": "What the token is used for (up to 500 characters).", "maxLength": 500, "type": "string" }, { "type": "null" }], "description": "New description; `null` clears it." }, "name": { "description": "Name of the token (1 to 100 characters).", "maxLength": 100, "minLength": 1, "type": "string" } }, "type": "object" }, "response": { "properties": { "created_at": { "description": "When the token was created (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "created_by": { "description": "Id of the user or credential that created the token.", "type": "string" }, "description": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "What the token is used for; `null` when there is none." }, "expires_at": { "anyOf": [{ "description": "When the token expires (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" }], "description": "When the token expires (RFC 3339); `null` if it does not expire." }, "id": { "description": "Id of the token.", "type": "string" }, "kind": { "description": "`personal` acts as a user; `organization` acts as the organization itself.", "enum": ["personal", "organization"], "type": "string" }, "last_used_at": { "anyOf": [{ "description": "When the token was last used (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" }], "description": "When the token was last used (RFC 3339); `null` if it never was." }, "name": { "description": "Name of the token.", "type": "string" }, "organization_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the organization the token is limited to; `null` for a personal token of all organizations." }, "permissions": { "description": "Permissions the token grants.", "items": { "description": "Permission level: `query`, `read`, `write` or `admin`.", "enum": ["query", "read", "write", "admin"], "type": "string" }, "type": "array" }, "prefix": { "description": "First characters of the token value, to recognize it.", "type": "string" }, "revoked_at": { "anyOf": [{ "description": "When the token was revoked (RFC 3339).", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" }], "description": "When the token was revoked (RFC 3339); `null` if it is still valid." }, "suffix": { "description": "Last characters of the token value, to recognize it.", "type": "string" }, "type": { "const": "token", "description": "Object type, always `token`.", "type": "string" }, "user_id": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Id of the user the token belongs to; `null` for an organization token." } }, "required": ["type", "id", "kind", "user_id", "organization_id", "permissions", "prefix", "suffix", "name", "description", "last_used_at", "expires_at", "revoked_at", "created_by", "created_at"], "type": "object" } },
17
+ };
18
+ //# sourceMappingURL=schemas.js.map