Projects

Project context management for content generation

Get all projects for the authenticated user

get

Retrieves all active projects owned by the authenticated user. Projects are returned in descending order by last update time.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

List of user's projects

application/json

idstringOptional

Unique identifier for the project (GUID)

Example: 123e4567-e89b-12d3-a456-426614174000

namestringOptional

Name of the project

Example: AI Startup Launch

descriptionstringOptional

Detailed description of the project

Example: Building an AI-powered SaaS tool for content creators. Focus on automation, efficiency, and user experience.

urlstringOptional

Optional URL associated with the project

Example: https://example.com

tokenstringOptional

Client token (owner of the project)

Example: abc123-def456-ghi789

createdOnstring · date-timeOptional

Creation timestamp

Example: 2024-01-01T12:00:00Z

updatedOnstring · date-timeOptional

Last update timestamp

Example: 2024-01-02T14:30:00Z

activebooleanOptional

Whether the project is active

Example: true

imageUrlstring · uriOptional

Optional URL of the 200x50 brand image associated with the project

textColorstring · nullableOptional

Hex color (e.g.

Example: #111827

backgroundColorstring · nullableOptional

Hex color (e.g.

Example: #F9FAFB

brandColorstring · nullableOptional

Primary branding accent color applied to overlay shapes when branding is configured

Example: #4338CA

accentColorstring · nullableOptional

Secondary accent color applied to overlay highlights and subtitles when branding is configured

Example: #7C72EF

401

Unauthorized - valid API token required

500

Internal server error

get

/projects

HTTPcURLJavaScriptPython

GET /projects HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "AI Startup Launch",
    "description": "Building an AI-powered SaaS tool for content creators. Focus on automation, efficiency, and user experience.",
    "url": "https://example.com",
    "token": "abc123-def456-ghi789",
    "createdOn": "2024-01-01T12:00:00Z",
    "updatedOn": "2024-01-02T14:30:00Z",
    "active": true,
    "imageUrl": "https://example.com",
    "textColor": "#111827",
    "backgroundColor": "#F9FAFB",
    "brandColor": "#4338CA",
    "accentColor": "#7C72EF"
  }
]

Create a new project

post

Creates a new project for the authenticated user. Projects can be referenced when generating tweets/threads to provide context.

If a URL is provided without a description, the API will:

1. Fetch the website content

2. Use AI to generate a comprehensive project description in markdown format

Either description or url must be provided.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringRequired

Name of the project (max 200 characters)

Example: AI Startup Launch

descriptionstringOptional

Detailed description of the project. Either description or url must be provided.

Example: Building an AI-powered SaaS tool for content creators. Focus on automation, efficiency, and user experience.

urlstringOptional

Optional URL to fetch website content for auto-generating description. If provided without a description, AI will generate one.

Example: https://example.com

imageDatastringOptional

Optional base64 encoded PNG/JPG representing the project's brand image. Any dimensions are accepted—the API resizes it to 200x50 and flattens transparency onto a white background before storing the hosted copy as imageUrl.

imageUrlstring · uriOptional

Optional HTTP/HTTPS URL to an existing PNG or JPG brand image. The API downloads the source, resizes it to 200x50, flattens transparency onto a white background, and hosts the optimized copy. Cannot be combined with imageData.

textColorstringOptional

Optional hex color (format

Example: #111827Pattern: ^#[0-9A-Fa-f]{6}$

backgroundColorstringOptional

Optional hex color (format

Example: #F9FAFBPattern: ^#[0-9A-Fa-f]{6}$

brandColorstringOptional

Optional primary accent hex color (format

Example: #4338CAPattern: ^#[0-9A-Fa-f]{6}$

accentColorstringOptional

Optional secondary accent hex color (format

Example: #7C72EFPattern: ^#[0-9A-Fa-f]{6}$

Responses

201

Project created successfully

application/json

400

Bad request - Missing required fields or validation error

application/json

401

Unauthorized - valid API token required

500

Internal server error

post

/projects

HTTPcURLJavaScriptPython

POST /projects HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 330

{
  "name": "AI Startup Launch",
  "description": "Building an AI-powered SaaS tool for content creators. Focus on automation, efficiency, and user experience.",
  "url": "https://example.com",
  "imageData": "text",
  "imageUrl": "https://example.com",
  "textColor": "#111827",
  "backgroundColor": "#F9FAFB",
  "brandColor": "#4338CA",
  "accentColor": "#7C72EF"
}

{
  "success": true,
  "project": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "AI Startup Launch",
    "description": "Building an AI-powered SaaS tool for content creators. Focus on automation, efficiency, and user experience.",
    "url": "https://example.com",
    "token": "abc123-def456-ghi789",
    "createdOn": "2024-01-01T12:00:00Z",
    "updatedOn": "2024-01-02T14:30:00Z",
    "active": true,
    "imageUrl": "https://example.com",
    "textColor": "#111827",
    "backgroundColor": "#F9FAFB",
    "brandColor": "#4338CA",
    "accentColor": "#7C72EF"
  }
}

Get a specific project by ID

get

Retrieves a specific project by its ID. Only the project owner can access their projects.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Project ID (GUID)

Example: 123e4567-e89b-12d3-a456-426614174000

Responses

200

Project details

application/json

idstringOptional

Unique identifier for the project (GUID)

Example: 123e4567-e89b-12d3-a456-426614174000

namestringOptional

Name of the project

Example: AI Startup Launch

descriptionstringOptional

Detailed description of the project

Example: Building an AI-powered SaaS tool for content creators. Focus on automation, efficiency, and user experience.

urlstringOptional

Optional URL associated with the project

Example: https://example.com

tokenstringOptional

Client token (owner of the project)

Example: abc123-def456-ghi789

createdOnstring · date-timeOptional

Creation timestamp

Example: 2024-01-01T12:00:00Z

updatedOnstring · date-timeOptional

Last update timestamp

Example: 2024-01-02T14:30:00Z

activebooleanOptional

Whether the project is active

Example: true

imageUrlstring · uriOptional

Optional URL of the 200x50 brand image associated with the project

textColorstring · nullableOptional

Hex color (e.g.

Example: #111827

backgroundColorstring · nullableOptional

Hex color (e.g.

Example: #F9FAFB

brandColorstring · nullableOptional

Primary branding accent color applied to overlay shapes when branding is configured

Example: #4338CA

accentColorstring · nullableOptional

Secondary accent color applied to overlay highlights and subtitles when branding is configured

Example: #7C72EF

400

Bad request - Missing project ID

401

Unauthorized - valid API token required

404

Project not found

500

Internal server error

get

/projects/{id}

HTTPcURLJavaScriptPython

GET /projects/{id} HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "AI Startup Launch",
  "description": "Building an AI-powered SaaS tool for content creators. Focus on automation, efficiency, and user experience.",
  "url": "https://example.com",
  "token": "abc123-def456-ghi789",
  "createdOn": "2024-01-01T12:00:00Z",
  "updatedOn": "2024-01-02T14:30:00Z",
  "active": true,
  "imageUrl": "https://example.com",
  "textColor": "#111827",
  "backgroundColor": "#F9FAFB",
  "brandColor": "#4338CA",
  "accentColor": "#7C72EF"
}

Update a project

post

Updates an existing project's name and description. Only the project owner can update their projects.

If a URL is provided without a description, the API will:

1. Fetch the website content

2. Use AI to generate a comprehensive project description in markdown format

Either description or url must be provided.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Project ID (GUID)

Example: 123e4567-e89b-12d3-a456-426614174000

Body

application/json

namestringRequired

Updated name of the project (max 200 characters)

Example: AI SaaS Platform

descriptionstringOptional

Updated description of the project. Either description or url must be provided.

Example: Revolutionary AI-powered content creation platform with advanced automation features.

urlstringOptional

Optional URL to fetch website content for auto-generating description. If provided without a description, AI will generate one.

Example: https://example.com

imageDatastring · nullableOptional

Optional base64 encoded PNG/JPG. Provide null to remove the current brand image. Any size is accepted and will be resized to 200x50 and flattened onto a white background on upload.

imageUrlstring · uri · nullableOptional

Optional HTTP/HTTPS URL pointing to a PNG or JPG brand image. Provide null to remove the stored image. The API stores a 200x50 white-background version. Cannot be combined with imageData.

textColorstring · nullableOptional

Optional hex color (format

Example: #111827Pattern: ^#[0-9A-Fa-f]{6}$

backgroundColorstring · nullableOptional

Optional hex color (format

Example: #F9FAFBPattern: ^#[0-9A-Fa-f]{6}$

brandColorstring · nullableOptional

Optional primary accent hex color (format

Example: #4338CAPattern: ^#[0-9A-Fa-f]{6}$

accentColorstring · nullableOptional

Optional secondary accent hex color (format

Example: #7C72EFPattern: ^#[0-9A-Fa-f]{6}$

Responses

200

Project updated successfully

application/json

successbooleanOptionalExample: true

400

Bad request - Missing required fields or validation error

401

Unauthorized - valid API token required

404

Project not found or unauthorized

500

Internal server error

post

/projects/{id}/update

HTTPcURLJavaScriptPython

POST /projects/{id}/update HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 306

{
  "name": "AI SaaS Platform",
  "description": "Revolutionary AI-powered content creation platform with advanced automation features.",
  "url": "https://example.com",
  "imageData": "text",
  "imageUrl": "https://example.com",
  "textColor": "#111827",
  "backgroundColor": "#F9FAFB",
  "brandColor": "#4338CA",
  "accentColor": "#7C72EF"
}

{
  "success": true,
  "project": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "AI Startup Launch",
    "description": "Building an AI-powered SaaS tool for content creators. Focus on automation, efficiency, and user experience.",
    "url": "https://example.com",
    "token": "abc123-def456-ghi789",
    "createdOn": "2024-01-01T12:00:00Z",
    "updatedOn": "2024-01-02T14:30:00Z",
    "active": true,
    "imageUrl": "https://example.com",
    "textColor": "#111827",
    "backgroundColor": "#F9FAFB",
    "brandColor": "#4338CA",
    "accentColor": "#7C72EF"
  }
}

Delete a project

post

Soft deletes a project (marks it as inactive). Only the project owner can delete their projects.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Project ID (GUID)

Example: 123e4567-e89b-12d3-a456-426614174000

Responses

200

Project deleted successfully

application/json

successbooleanOptionalExample: true

messagestringOptionalExample: Project deleted successfully

400

Bad request - Missing project ID

401

Unauthorized - valid API token required

404

Project not found or unauthorized

500

Internal server error

post

/projects/{id}/delete

HTTPcURLJavaScriptPython

POST /projects/{id}/delete HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "message": "Project deleted successfully"
}