REST API

ACPT REST API endpoint reference

ACPT exposes a complete REST API under the acpt/v1 namespace. All standard WordPress REST API conventions apply.

Base URL

{site_url}/wp-json/acpt/v1

Authentication

Two methods are supported:

• Basic authentication — Authorization: Basic base64(username:password)

• API key — acpt-api-key: {your-api-key} (recommended)

To generate an API key, go to ACPT → Tools → API Dashboard. See Custom APIs for full setup instructions.

Interactive docs (Swagger UI)

The full OpenAPI schema is available at:

GET /wp-json/acpt/v1/schema

The ACPT admin dashboard includes a Swagger UI playground at ACPT → Tools → API Dashboard.

---

Endpoints

Custom Post Types

Method	Path	Auth	Description
GET	/acpt/v1/cpt	Required	List all custom post types
GET	/acpt/v1/cpt/{slug}	Required	Get a custom post type
POST	/acpt/v1/cpt	Required	Create a custom post type
PUT	/acpt/v1/cpt/{slug}	Required	Update a custom post type
DELETE	/acpt/v1/cpt/{slug}	Required	Delete a custom post type

curl -X GET "https://example.com/wp-json/acpt/v1/cpt" \
  -H "acpt-api-key: your-api-key"

---

Taxonomies

Method	Path	Auth	Description
GET	/acpt/v1/taxonomy	Required	List all taxonomies
GET	/acpt/v1/taxonomy/{slug}	Required	Get a taxonomy
POST	/acpt/v1/taxonomy	Required	Create a taxonomy
PUT	/acpt/v1/taxonomy/{slug}	Required	Update a taxonomy
DELETE	/acpt/v1/taxonomy/{slug}	Required	Delete a taxonomy
POST	/acpt/v1/taxonomy/assoc/{slug}/{cpt}	Required	Associate a taxonomy with a post type

curl -X POST "https://example.com/wp-json/acpt/v1/taxonomy" \
  -H "acpt-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"slug":"genre","singular":"Genre","plural":"Genres"}'

---

Option Pages

Method	Path	Auth	Description
GET	/acpt/v1/option-page	Required	List all option pages
GET	/acpt/v1/option-page/{slug}	Required	Get an option page
POST	/acpt/v1/option-page	Required	Create an option page
PUT	/acpt/v1/option-page/{slug}	Required	Update an option page
DELETE	/acpt/v1/option-page/{slug}	Required	Delete an option page

---

Meta Fields

Method	Path	Auth	Description
GET	/acpt/v1/meta	Required	List all meta field groups
GET	/acpt/v1/meta/{id}	Required	Get a meta field group
POST	/acpt/v1/meta	Required	Create a meta field group
PUT	/acpt/v1/meta/{id}	Required	Update a meta field group
DELETE	/acpt/v1/meta/{id}	Required	Delete a meta field group

curl -X GET "https://example.com/wp-json/acpt/v1/meta" \
  -H "acpt-api-key: your-api-key"

---

Forms

Method	Path	Auth	Description
GET	/acpt/v1/form	Required	List all forms
GET	/acpt/v1/form/{id}	Required	Get a form
POST	/acpt/v1/form	Required	Create a form
PUT	/acpt/v1/form/{id}	Required	Update a form
DELETE	/acpt/v1/form/{id}	Required	Delete a form
POST	/acpt/v1/form/submission/{key}	None	Submit a form (public endpoint)

---

Dynamic Blocks

Method	Path	Auth	Description
GET	/acpt/v1/block	Required	List all dynamic blocks
GET	/acpt/v1/block/{id}	Required	Get a dynamic block
POST	/acpt/v1/block	Required	Create a dynamic block
PUT	/acpt/v1/block/{id}	Required	Update a dynamic block
DELETE	/acpt/v1/block/{id}	Required	Delete a dynamic block

---

WooCommerce Product Data

Method	Path	Auth	Description
GET	/acpt/v1/woocommerce/product-data	Required	List all product data entries
GET	/acpt/v1/woocommerce/product-data/{id}	Required	Get a product data entry
POST	/acpt/v1/woocommerce/product-data	Required	Create a product data entry
PUT	/acpt/v1/woocommerce/product-data/{id}	Required	Update a product data entry
DELETE	/acpt/v1/woocommerce/product-data/{id}	Required	Delete a product data entry
GET	/acpt/v1/woocommerce/product-data/{id}/fields	Required	List fields for a product data entry
POST	/acpt/v1/woocommerce/product-data/{id}/fields	Required	Create a field
PUT	/acpt/v1/woocommerce/product-data/{id}/fields	Required	Update fields
DELETE	/acpt/v1/woocommerce/product-data/{id}/fields	Required	Delete all fields
GET	/acpt/v1/woocommerce/product-data/{id}/fields/{field}	Required	Get a specific field
DELETE	/acpt/v1/woocommerce/product-data/{id}/fields/{field}	Required	Delete a specific field

---

Filter / Query

Method	Path	Auth	Description
POST	/acpt/v1/{slug}/filter/query	Required	Filter posts of a given post type by custom meta query

curl -X POST "https://example.com/wp-json/acpt/v1/movie/filter/query" \
  -H "acpt-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"filters":[{"box":"info","field":"year","value":"2024","operator":"="}]}'

---

License

Method	Path	Auth	Description
POST	/acpt/v1/license/deactivate	None	Deactivate the current license

---

Custom Content Types — Table Records (Beta)

These endpoints are available as Beta in ACPT 2.1.0. The request/response format may change before the stable release.

Table-record endpoints are only available when:

1. The table has Expose via REST API enabled in its General settings.

2. A valid ACPT license is active.

Method	Path	Auth	Description
GET	/acpt/v1/table-records/{tableName}	Required	List all records in a table. Supports filtering, ordering, and pagination (see below).
GET	/acpt/v1/table-records/{tableName}/{id}	Required	Get a single record by ID.
POST	/acpt/v1/table-records/{tableName}	Required	Create a new record.
PUT	/acpt/v1/table-records/{tableName}/{id}	Required	Update an existing record.
DELETE	/acpt/v1/table-records/{tableName}/{id}	Required	Delete a record.

List records — query parameters

Parameter	Type	Description
page	integer	Page number (default: 1).
per_page	integer	Records per page (default: 10, max: 100).
orderby	string	Column name to order by.
order	string	ASC or DESC (default: ASC).
{columnName}	mixed	Filter by column value. E.g. ?director_id=1 returns all movies by director 1.

# List all movies directed by director ID 1, newest first
curl -X GET \
  "https://example.com/wp-json/acpt/v1/table-records/movies?director_id=1&orderby=year&order=DESC" \
  -H "acpt-api-key: your-api-key"

Create a record

curl -X POST "https://example.com/wp-json/acpt/v1/table-records/movies" \
  -H "acpt-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Blade Runner 2049",
    "year": 2017,
    "director_id": 1
  }'

File uploads

For columns of type Image, File, Video, or Audio, use multipart/form-data:

curl -X POST "https://example.com/wp-json/acpt/v1/table-records/movies" \
  -H "acpt-api-key: your-api-key" \
  -F "title=Blade Runner 2049" \
  -F "year=2017" \
  -F "poster=@/path/to/poster.jpg"

Response format

{
  "id": 1,
  "title": "Blade Runner 2049",
  "year": 2017,
  "director_id": 1,
  "created_at": "2026-06-08 10:00:00",
  "updated_at": "2026-06-08 10:00:00"
}