How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

cove.tool REST API v2

The current cove.tool REST API. Thirteen operations across six tags — User, Profiles, Energy Codes, Projects, Project Geometry and Daylight Analysis — covering account creation, project create/read/update, 3D geometry upload, energy-code lookup, and starting, polling, retrieving and stopping daylight/energy analysis runs. Token authentication is sent in the Authorization header; tokens are minted at https://app.covetool.com/api/get-token.

cove.tool REST API v2 is one of 2 APIs that Cove.Tool publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Building Performance, Daylight Analysis, Energy Modeling, Project, and Simulation. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 11 operations across 10 paths, organized into 6 resource areas, and defines 35 schemas. It is described by OpenAPI 3.0.0, at version 2.0.0.

Requests are made against a single base URL, https://app.covetool.com/api/v2.

11 operations 10 paths 35 schemas 6 GET4 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2.0.0
Base URL
https://app.covetool.com/api/v2
Authentication
API Key
Terms of Service
Resource Areas
6

Authentication & Security 1

cove.tool REST API v2 declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (apiKeyAuth).

Paths & Operations 11

Across 10 paths, the API surfaces 11 operations — 6 GET, 4 POST, 1 PUT. They span 6 resource areas: User, Profiles, Energy Codes, Projects, Project Geometry, Daylight Analysis. Each is listed below with its method, path, parameters, and response codes.

User 1
POST
/auth/signup
Enables the creation of a cove.tool user account
body → 201400
Profiles 1
GET
/profiles/{profile_id}
Obtain user information
1 param → 200403404
Energy Codes 1
GET
/energy-codes
Enumerates list of energy codes supported by cove.tool or in specific projects
2 params → 200401
Projects 3
POST
/projects/
Enables the creation of a new cove.tool project
body → 201400401
GET
/projects/
Retrieves a project's detail and information
1 param → 200404
PUT
/projects/{project_id}
Updates a project's detail and information
1 param body → 200400401
Project Geometry 1
POST
/projects/{project_id}/geometry
Updates a project's 3D geometry
1 param body → 201400
Daylight Analysis 4
POST
/analysis
Kickstarts all analysis types for a given project
body → 202400
GET
/analysis/{project_id}
Retrieves the results for daylight analysis for a given project
1 param → 200404400
GET
/analysis/{project_id}/status
Obtains the remaining number of jobs per analysis type for a given project
1 param → 200404400
GET
/analysis/{project_id}/stop
Halts all analyses calculations for a given project
1 param → 200404

Schemas 35

The contract defines 35 schemas that model the data the API accepts and returns. The most detailed are Update3DGeometryRequestBody (41 properties), CreateProjectResponseData (14 properties), UserInformationResponseData (7 properties), CreatedByResponseData (4 properties). Each schema is shown below with its type and property counts.

GeneralEndpointResponses
object
3 properties 3 required
UserSignupOKResponses
object
1 property
UserSignupRequests
object
4 properties 4 required
UserInformationResponseData
object
7 properties 7 required
UserProfileResponse
object
1 property
EnergyCodesEnum
string
Energy code names
EnergyCodeResponseData
object
2 properties 2 required
EnergyCodeForProjectResponseData
object
1 property 1 required
EnergyCodeResponses
object
1 property
EnergyCodeForProjectsResponses
object
1 property
CreatedByResponseData
object
4 properties 4 required
CreateProjectRequestBody
object
4 properties 4 required
CreateProjectResponseData
object
14 properties 14 required
CreateProjectResponse
object
1 property
GetProjectInfoResponse
object
1 property
EuiBreakdownHeaders
array
UpdateGeometryAreasResponses
object
1 property
Update3DGeometryResponseData
object
4 properties 4 required
Update3DGeometryResponses
object
1 property
Update3DGeometryRequestBody
object
41 properties 9 required
RoomsMeshObject
object
2 properties 2 required
RunDaylightAnalysisRequestBody
object
2 properties 2 required
RunDaylightAnalysisResponse
object
DaylightAnalysisResultsResponseData
array
DaylightAnalysisResultsResponse
object
1 property
DaylightAnalysisStatusResponseData
array
DaylightAnalysisStatusResponse
object
1 property
StopDaylightAnalysisResponse
object
VerticesObject
object
TrianglesArray
VerticesModel
object
3 properties
MeshObject
array
CenterObject
NormalObject
MeshObjectV2
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cove.tool-rest-api-v2-openapi.yml Raw ↑

Other APIs Cove.Tool publishes across the network.

cove.tool API v1
Where this information came from

This is an independent, third-party profile of cove.tool REST API v2, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.