List workspace run cap controls

curl --request GET \
  --url https://api.monid.ai/v1/controls/workspace/run-caps \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.monid.ai/v1/controls/workspace/run-caps', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.monid.ai/v1/controls/workspace/run-caps",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.monid.ai/v1/controls/workspace/run-caps"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.monid.ai/v1/controls/workspace/run-caps")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "runCapControlId": "01JC2Z0A9V8Q4R6T8Y0B2D4F6H",
      "workspaceId": "<string>",
      "limitAmount": 5,
      "currency": "USD",
      "status": "ACTIVE",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "cursor": "<string>"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

GET

controls

workspace

run-caps

List workspace run cap controls

curl --request GET \
  --url https://api.monid.ai/v1/controls/workspace/run-caps \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.monid.ai/v1/controls/workspace/run-caps', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.monid.ai/v1/controls/workspace/run-caps",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.monid.ai/v1/controls/workspace/run-caps"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.monid.ai/v1/controls/workspace/run-caps")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "runCapControlId": "01JC2Z0A9V8Q4R6T8Y0B2D4F6H",
      "workspaceId": "<string>",
      "limitAmount": 5,
      "currency": "USD",
      "status": "ACTIVE",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "cursor": "<string>"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

{
  "code": 400,
  "message": "Bad Request",
  "hints": {},
  "errorCode": "RATE_LIMITED"
}

Authorizations

Authorization

string

header

required

Monid API key (Authorization: Bearer mk_...) or Clerk-issued JWT. Each operation lists the ONE scope an API key needs. {resource}:* grants every action on that resource; * grants everything; Clerk sessions hold *. Operations with an empty list need no scope. Scope catalog: GET /v1/api-keys/scopes.

Headers

X-Monid-Agent-Model

string

Model driving the calling agent. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Maximum string length: 256

X-Monid-Agent-Harness

string

Agent harness or client making the call (e.g. a coding agent, an agent framework). Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Maximum string length: 256

X-Monid-Agent-Session-Id

string

Caller-side session identifier, so the calls of one agent session (discover → inspect → run → polling) can be correlated. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Maximum string length: 256

Query Parameters

limit

integer

Max items per page (server-side cap applies).

Required range: x <= 100

Example:

25

cursor

string

Cursor returned by the previous page.

Response

Run cap controls page

items

object[]

required

Show child attributes

cursor

string | null

required

Opaque cursor for the next page. Null on the last page.

Auth

Identities

API Keys

Discover

Endpoints

Inspect

Runs

Resources

Wallet

Controls

Public Registry

Rankings

List workspace run cap controls

Authorizations

Headers

Query Parameters

Response