Instructions for an Agent

View .md OpenAPI spec Open in Claude Open in ChatGPT

GET

/auth.md

const url = 'https://app.caprid.com/auth.md';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.caprid.com/auth.md

The steps an AI agent follows to register with this server’s WorkOS AuthKit domain, get an Agent token, and use it here. Point an agent at this page and it can start a trial with no help from you.

The first part is AuthKit’s own instructions, copied from AuthKit at most a minute ago, so they follow how AuthKit is set up. The last part says what to call here with the token: list the trial, find its Namespace, and create an API key.

Responses

200

The instructions, as Markdown.

text/plain

string

Example

# auth.md — agent registration

You are an agent. This service allows you to register for an identity and exchange it for credentials.
...

## 7. Use the access token with Switchboard
...

404

This server isn’t set up for Agents.

application/json

object

error

required

string

Example

{
  "error": "the requested grants exceed the key's scope"
}

502

AuthKit didn’t answer, or answered with an error.

application/json

object

error

required

string

Example

{
  "error": "the requested grants exceed the key's scope"
}