Documentation

Technical resources, API references, and integration guides for ACN platform services.

Getting Started

Welcome to the ACN API documentation. This guide will help you integrate our platform services into your applications. The ACN API is RESTful and returns JSON responses.

Base URL

https://api.acnagency.com/v1

Quick Start

To get started, you'll need your API credentials from the ACN dashboard. Once you have them, you can make your first request:

curl -X GET https://api.acnagency.com/v1/projects \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
Required Setup

Make sure your system has cURL 7.64+ or an HTTP client that supports modern TLS versions. Older SSL versions are not supported.

Authentication

ACN API uses Bearer token authentication. Include your API key in the Authorization header of every request.

Request Headers

Header Value
Authorization Bearer YOUR_API_KEY
Content-Type application/json
Keep Your API Key Secure

Never expose your API key in client-side code, version control, or sharing channels. Use environment variables or secure secret management.

API Reference

Projects

GET /projects

Retrieve a list of all projects in your workspace.

POST /projects

Create a new project with specified parameters.

GET /projects/{id}

Retrieve details for a specific project.

PUT /projects/{id}

Update an existing project's properties.

Assets

GET /assets

List all digital assets in your library.

POST /assets/upload

Upload a new asset. Supports images, videos, and documents up to 50MB.

Webhooks

Configure webhooks to receive real-time notifications when events occur in your ACN workspace. Webhooks are delivered via HTTP POST with a JSON payload.

Webhook Payload Structure

{ "event": "project.updated", "timestamp": "2026-04-07T12:00:00Z", "data": { "id": "proj_abc123", "status": "active" } }

Available Events

  • project.created — A new project was created
  • project.updated — Project properties changed
  • project.deleted — A project was removed
  • asset.uploaded — A new asset was uploaded
  • user.invited — A team member was invited

SDKs & Libraries

Official client libraries are available to simplify API integration.

JavaScript / Node.js

npm install @acnagency/sdk

Python

pip install acnagency

PHP

composer require acnagency/sdk

Changelog

Stay updated with the latest API changes and improvements.

April 2026

  • v1.4.0 — Added webhook delivery with retry logic and signature verification
  • v1.3.2 — Fixed pagination cursor for large result sets
  • v1.3.1 — Improved error messages for validation failures

March 2026

  • v1.3.0 — Released Assets API with upload support
  • v1.2.0 — Added Projects filtering and sorting options

Rate Limits

API requests are rate-limited to ensure fair usage across all clients.

Plan Requests/minute Requests/day
Starter 60 10,000
Professional 300 100,000
Enterprise 1,000 Unlimited

Rate limit headers are included in every response: X-RateLimit-Remaining and X-RateLimit-Reset.

Error Codes

The API uses standard HTTP status codes. Error responses include a JSON body with details.

Code Meaning
400 Bad Request — Invalid parameters provided
401 Unauthorized — Invalid or missing API key
403 Forbidden — Insufficient permissions
404 Not Found — Resource does not exist
429 Too Many Requests — Rate limit exceeded
500 Internal Server Error — Something went wrong on our end