Skip to main content

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. Optionally clone the public Spaaza Postman collection for side-by-side use: https://github.com/Spaaza/SPAAZA.postman
  4. Start your session with a prompt like: "Use test01 and help me log in to Spaaza API. I already have the Spaaza Postman collection cloned at ...."

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.
  • Keep cached issued session data only in a user-local directory outside any repository and never store usernames, passwords, or OTP codes.
  • If you choose to enable remembered Postman clone paths, store only the collection location in a user-local config outside any repository.

Trust boundaries​

Use only trusted agents and trusted execution environments.

The skills emphasise minimal secret handling and explicit user consent, 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

If you use persistent session reuse, cached sessions should be kept per environment and reused only when they still match the requested environment and have not expired.

Skill catalogue​

SkillPurposeSkill pageSkill file
Talk to the Spaaza APILet an AI agent authenticate, query data, perform approved changes, and use the Spaaza Postman collection to shape requests.Talk to the Spaaza APIspaaza-api-live-access SKILL.md
Investigate API requestsLet an AI agent analyse request/response evidence and explain what happened and why.Investigate API requestsspaaza-api-request-investigator SKILL.md

Installing a skill​

Use the repository-relative skill file links below: