Link Search Menu Expand Document

AI Agent Skills

AI Agent Skills are reusable instruction files that help AI assistants work with the Spaaza API safely and consistently.

This is useful when you want to use natural language to work with Spaaza, for example:

  • “Show me the latest campaigns for my chain”
  • “Update this campaign title”
  • “Investigate why this API request failed”

Think of this as text-based interaction with the Spaaza platform, similar in spirit to Spaaza Console workflows, but driven by guided prompts and API calls.

Quickstart

  1. Open this page and choose the skill you want to use.
  2. Install the skill from the repository-relative SKILL.md link.
  3. Start your session with a prompt like: “Use test01 and help me log in to Spaaza API.”

Security first

Security is critical when using AI agents with APIs.

  • Only provide credentials when needed.
  • Treat credentials, OTP codes, and session keys as sensitive.
  • Use staging (test01) before production unless production is explicitly required.

Trust boundaries

Use only trusted agents and trusted execution environments.

The skill enforces session-only handling guidance, but users should still validate where the agent runs and what it can access before sharing credentials.

Session expiry and re-login

Sessions and OTP codes can expire.

If a login/session call fails due to expiry or timeout, restart the login flow:

  1. POST /auth/login
  2. provide fresh OTP
  3. POST /auth/session

Skill catalogue

Skill Purpose Skill page Skill file
Talk to the Spaaza API Let an AI agent authenticate, query data, and perform approved changes via Spaaza API endpoints. Talk to the Spaaza API spaaza-api-live-access SKILL.md
Investigate API requests Let an AI agent analyse request/response evidence and explain what happened and why. Investigate API requests spaaza-api-request-investigator SKILL.md

Installing a skill

Use the repository-relative skill file links below:


Table of contents