🧩Create a Project (Brand Assets)

Projects let you save a reusable brand package (description, logo, and optional colors) and apply it to future outputs by passing the project ID in the projects array.

Before You Begin

• Have your API token ready (Authorization: Bearer ...).

• Prepare a project name and either a description or a website URL.

• (Optional) Prepare a logo image as either a public URL (PNG/JPG) or a base64-encoded PNG/JPG.

• (Optional) Pick brand colors as hex values like #111827.

Step 1: Create the Project

Create a project by calling POST /projects.

curl -X POST "https://api.autocontentapi.com/projects" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Startup Launch",
    "description": "Brand kit and positioning for our launch assets.",
    "imageUrl": "https://cdn.example.com/brand/logo.png",
    "textColor": "#111827",
    "backgroundColor": "#F9FAFB",
    "brandColor": "#4338CA",
    "accentColor": "#7C72EF"
  }'

The response includes the full project record, including its id:

{
  "success": true,
  "project": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "AI Startup Launch",
    "description": "Brand kit and positioning for our launch assets.",
    "imageUrl": "https://autocontentapi.com/uploads/projects/123e.../logo-200x50.png",
    "brandColor": "#4338CA",
    "accentColor": "#7C72EF",
    "createdOn": "2024-01-01T12:00:00Z",
    "updatedOn": "2024-01-02T14:30:00Z",
    "active": true
  }
}

Step 2: Request Parameters (All Fields)

The request body follows CreateProjectRequest:

Field	Required	Type	Notes
name	✅	string	Project name (max 200 characters).
description	✅*	string	Human-written project description. Markdown is supported. Either description or url must be provided.
url	✅*	string	Website URL for the project. If you provide url without description, the API fetches the site and generates a description automatically.
imageData	Optional	string	Base64-encoded PNG/JPG for the brand image. Any dimensions accepted; the API resizes it to 200x50 and stores the hosted copy as imageUrl. Cannot be combined with imageUrl.
imageUrl	Optional	string	Public HTTP/HTTPS URL to a PNG/JPG brand image. The API downloads it, resizes to 200x50, and hosts the optimized copy. Cannot be combined with imageData.
textColor	Optional	string	Hex color #RRGGBB used for branded text when applicable.
backgroundColor	Optional	string	Hex color #RRGGBB used for branded backgrounds when applicable.
brandColor	Optional	string	Hex color #RRGGBB used as the primary branding accent in supported outputs.
accentColor	Optional	string	Hex color #RRGGBB used as the secondary accent in supported outputs.

* Either description or url is required.

Uploading a logo via imageData

If you prefer to avoid hosting a logo yourself, send it as base64:

curl -X POST "https://api.autocontentapi.com/projects" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Startup Launch",
    "description": "Brand kit and positioning for our launch assets.",
    "imageData": "iVBORw0KGgoAAAANSUhEUgAA..."
  }'

Step 3: Use the Project ID in Content Generation

Once created, apply the saved brand assets by including the project ID in projects when calling /content/Create:

curl -X POST "https://api.autocontentapi.com/content/Create" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "outputType": "video",
    "projects": ["123e4567-e89b-12d3-a456-426614174000"],
    "resources": [{ "type": "text", "content": "Announce our product launch." }],
    "text": "Keep this under 90 seconds with a clear CTA."
  }'

Examples:

• Explainer videos: Apply Brand Logo with projectId

• Infographics: Apply Brand Settings with projectId

• Slide decks: Apply Brand Logo with projectId

Related Endpoints

• POST /projects – Create a project and store brand assets.

• GET /projects – List your active projects.

• GET /projects/{id} – Fetch a project by ID.

• POST /projects/{id}/update – Update a project (including swapping/removing image and colors).

• POST /projects/{id}/delete – Soft-delete a project (marks it inactive).

What's Next?

• Apply branding to a video via Apply Brand Logo with projectId.

• Generate a branded one-pager via Infographic Scenario Examples.

• Build a branded deck via Slide Deck Scenario Examples.