Developer Platform

Developer Platform

Programmatic access to your developer account

Everything you can do in the dashboard, you can do with code. The Developer Platform is a REST API plus webhooks and automation, built for CI/CD, bulk operations, and integrations.

Base URL & versioning

https://api.theaimart.co/api/v1

The API is versioned in the path. Breaking changes ship under a new version; additive changes (new fields, endpoints) do not.

Authenticate

Send an API key as a bearer token on every request:

curl https://api.theaimart.co/api/v1/apps \
  -H "Authorization: Bearer $THEAIMART_API_KEY"

A minimal end‑to‑end flow

# List your listings
curl https://api.theaimart.co/api/v1/apps \
  -H "Authorization: Bearer $THEAIMART_API_KEY"

# Create one
curl -X POST https://api.theaimart.co/api/v1/apps \
  -H "Authorization: Bearer $THEAIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Notes AI", "category": "Productivity", "description": "..." }'

# Publish a release
curl -X POST https://api.theaimart.co/api/v1/releases \
  -H "Authorization: Bearer $THEAIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "listing_id": "app_123", "version": "1.0.0", "channel": "stable" }'

Conventions

  • •JSON everywhere; send Content-Type: application/json.
  • •IDs are prefixed (app_, agent_, rel_, usr_) so they're self‑describing in logs.
  • •Timestamps are ISO‑8601 UTC.
  • •Errors use standard HTTP codes with a structured body — see REST API Reference.

Rate limits

Responses include limit headers; back off on 429:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 573
X-RateLimit-Reset: 1735689600

Building an integration others will install? Pair the API with Webhooks for push updates instead of polling, and Automation for scheduled jobs.

Next