Skip to content

Getting Started

Bastyn is an AI agent certification platform. Use the public API to submit an agent’s repository for analysis and receive a signed certification report.

Quick Start

  1. Create an API key in Settings → Environments.

  2. Submit your repository:

    Terminal window
    curl -X POST https://api.bastyn.ai/v1/workflow/projects \
      -H "Authorization: Bearer bastyn_sk_your_key" \
      -H "Content-Type: application/json" \
      -d '{"name": "my-agent", "repo_url": "https://github.com/your-org/your-agent"}'

    Save the project_id from the response.

  3. Start the certification workflow:

    Terminal window
    curl -X POST https://api.bastyn.ai/v1/workflow/projects/{project_id}/start \
      -H "Authorization: Bearer bastyn_sk_your_key"

    Save the run_id from the response.

  4. Poll for completion:

    Terminal window
    curl https://api.bastyn.ai/v1/workflow/runs/{run_id} \
      -H "Authorization: Bearer bastyn_sk_your_key"

    When status is completed, your attestation report is ready.

Base URL

https://api.bastyn.ai/v1

All requests require an Authorization: Bearer <api_key> header. See Authentication for details.

Next steps

Explore every endpoint in the API Reference.