canonical: https://jentic.com/apis/constech.io/constech

# Constech API

Jentic publishes the only available OpenAPI specification for the Constech API, keeping it validated and agent-ready. The Constech API manages projects and the tasks inside them, runs a task, and records the entries a task produces. It browses a portal of entities organized into folders and filtered by brand or account, lists task types, and tracks asset jobs. Authentication uses an API key sent in the x-api-key header.

## For AI agents

Manage Constech projects and their tasks, run tasks and record their entries, and browse a portal of brand and account entities organized in folders.

## Scope

Does not handle payments, messaging, or user authentication beyond its API key. Use for managing Constech projects, tasks, entries, and portal entities only.

## Capabilities

- List and create projects
- Create and update tasks within a project
- Run a task and record the entries it produces
- Attach media and templates to a task
- Browse portal entities filtered by brand or account
- Organize portal entities into folders

## Use cases

### Agent-Run Task Automation

An AI agent connected through Jentic can drive Constech work end to end: it creates a task inside a project, runs the task, and reads the entries the run produces. Because tasks are addressed by project and task id, the agent operates against a specific project's workflow.

Example prompt: Create a task in a project, run it, and read the entries it produces

### Project and Task Tracking

Keeping work visible means querying the current state. Constech lists projects filtered by status, tag, or account and lists the tasks inside a project, so an agent can report which projects are active and what work sits under each one without opening the app.

Example prompt: List the projects with a given status and the tasks inside a selected project

### Portal Entity Lookup

Constech's portal holds entities tied to a brand or account. The portal operations list entities filtered by brand name or account name and open a single entity by id, so an agent can look up the right entity before attaching work to it.

Example prompt: Find portal entities for a brand and open one entity by id

### Task Setup with Templates

Repeatable work benefits from a starting point. Constech attaches a template and media to a task, so an agent can create a task and pre-load it with the template and assets it needs before the task is run.

Example prompt: Create a task and attach a template and media to it

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/projects` | List projects |
| POST | `/projects` | Create a project |
| GET | `/projects/{projectId}/tasks` | List the tasks in a project |
| POST | `/projects/{projectId}/tasks` | Create a task in a project |
| POST | `/projects/{projectId}/tasks/{taskId}/run` | Run a task |
| POST | `/projects/{projectId}/tasks/{taskId}/entries` | Create an entry under a task |
| GET | `/portal/folders` | List portal folders |

## Key resources

- **Projects** — List, create, update, and delete projects
- **Tasks** — Create tasks, run them, and attach media and templates
- **Entries** — Read and manage the entries a task produces
- **Portal** — Browse portal entities and the folders that organize them

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 7 / 100
- **Maturity:** Non-Ready
- **Dimensions:**
  - Foundational Compliance: 74 / 100
  - Developer Experience & Jentic Compatibility: 69 / 100
  - AI-Readiness & Agent Experience: 10 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 1 / 100
- **View full report:** https://jentic.com/apis/constech.io/constech/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Constech API by hand means handling its x-api-key header, resolving the base path on its dev host, and nesting task calls under project and task ids. Through Jentic you install once, import Constech from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Constech puts the project id in the URL path (`/projects/{projectId}/...`), so a rule can pin your agent to one project: it can read and run tasks in that project and nothing else. You choose the operations it may call, so deleting a project or a task is not included unless you add them.
- **Credential handling:** Your Constech key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'run a task in a project' or 'list projects by status', and Jentic returns the matching Constech operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Asana** — Asana manages projects and tasks for teams with assignments and due dates.
- **ClickUp** — ClickUp combines tasks, docs, and workflows in one workspace.
- **Trello** — Trello organizes tasks as cards on boards and lists.
- **Notion** — Notion stores docs and databases that can hold project context alongside Constech tasks.

## FAQ

### Why is there no official OpenAPI spec for the Constech API?

Constech does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the Constech API via structured tooling. It is validated against the live API and kept up to date. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### What authentication does the Constech API use?

The Constech API authenticates with an API key sent in the x-api-key request header per its OpenAPI spec. When you call it through Jentic, that key is stored once by your own Jentic One instance and injected at execution time, so it never reaches the agent's prompt or logs.

### Can I run a task with the Constech API?

Yes. A task is addressed by its project id and task id, and the run operation executes it, after which the entries operations return the entries the run produced. This lets an agent trigger a task and read its output rather than only reading existing data.

### What are the rate limits for the Constech API?

The OpenAPI spec does not define numeric rate limits for the Constech API. Check the Constech documentation at https://constech.io for the current request limits that apply to your key.

### Can I limit what my agent is allowed to do with the Constech API?

Yes. Constech puts the project id in the URL path, so write a rule that allows only the task list and run operations within one project: the agent can then run that project's tasks and read their entries but cannot delete a task or a project, and every call it makes is logged.

### How do I run a task with the Constech API through Jentic?

Search Jentic with an intent like 'run a task in a project', and Jentic returns the run operation at `/projects/{projectId}/tasks/{taskId}/run` with its input schema so your agent passes the project and task ids and then reads the entries the run produced.

### Is there a Constech MCP server?

You don't need an MCP server to give your agent the Constech API. Jentic connects it directly from the API Directory: import the API, store your x-api-key once, and your agent calls the project, task, and portal operations on demand.