Quickstart

Make your first governed call against the AISquare API, complete and copy-paste runnable, then read the response.

Here to govern or observe agents?

Then your quickstart is Connect your agents — the SDK and proxy paths that put traces, policy verdicts, and enforcement on your agents. This page covers the Studios content API.

You will make one authenticated request to the AISquare API, get a real response back, and understand what you got. Copy the call below, run it, and you are done in under a minute.

Your first call

This is a complete request. It carries the auth header, hits a live endpoint, and sends a body. Paste it into a terminal and run it.

First request

curl -X POST https://api.aisquare.com/api/v1/aistudios/experiences/flattened/ \
  -H "Authorization: Bearer aisq_sandbox_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "ai-research-studio"
  }'

The response comes back immediately:

Response

{
  "count": 12,
  "results": [
    {
      "experience_id": 123,
      "experience_title": "Advanced Machine Learning Models",
      "resource_type": "AI_EXPERT",
      "resource_title": "Image Classification Expert",
      "publication_title": "AI Research Studio",
      "metrics": {
        "views": 1250,
        "likes": 89
      }
    }
  ]
}

Sandbox values

aisq_sandbox_key and ai-research-studio are illustrative sandbox values so this call works with no setup. Swap in your own workspace API key (see Authentication) and a studio url you own to query live data.

What just happened

Authenticated the request

The Authorization: Bearer <api_key> header identifies your workspace. Every AISquare request carries it. The sandbox key above is read-only and rate limited; your real key unlocks your own data.

Targeted a studio

The body's url field is the public identifier of an AI Studio (publication_custom_url). ai-research-studio is a sandbox studio. Point this at a studio you own to fetch its content.

Called the endpoint

POST /aistudios/experiences/flattened/ returns the resources inside a studio, such as AI experts, notes, and quests, one row per resource so a UI can render them as a flat list.

Read the response

count is the total number of matching resources. Each item in results carries its experience, its resource type and title, the publication it belongs to, and engagement metrics. See Core Concepts for what each field means.

Base URL

Every endpoint lives under one base URL:

https://api.aisquare.com/api/v1/

Filtering and pagination

Most list endpoints accept the same query parameters, so you can page and sort without learning a new shape each time.

Parameter	Description
`page`	Page number
`page_size`	Results per page
`search`	Search content
`ordering`	Sort results

For example, fetch the trending resources on the first page:

GET /aistudios/experiences/flattened/?ordering=trending&page=1

Next step

Authentication

Create a workspace API key, store it as an environment variable, and let the SDK read it so your calls run as you.

Quickstart

Authentication

On this page