Skip to content

Create a project

You can create a project using the endpoint POST /projects.

Authentication

The following header is required for all API calls:

  • X-Manufactory-Auth - Manufactory access token

Required keys

  • org_id (required) string - Manufactory org ID.
  • name (required) string - The desired project name.
  • description (required) string - A description for the project.
  • timezone (required) string - The preferred timezone for displaying dates. For example, New York (Eastern) would be America/New_York. A complete list of valid timezones (All timestamps are stored in UTC timezone, this selection is intended for displaying only)

Request example

{
"org_id": "master",
"name": "Prod",
"description": "A project for prod data",
"timezone": "America/Chicago"
}

Response example

{
"org_id": "xyz",
"project_id": 10003,
"name": "Prod",
"description": "A project for prod data",
"timezone": "America/Chicago",
"created_at": "2023-02-08 17:13:26",
"project_key": "***********************"
}

Projects > Update a project

The PUT endpoint enables updating a Manufactory project’s name description and timezone by providing the organization ID and project ID along with optional fields in the request body.

Projects > Get a project

The GET endpoint retrieves a single project’s details including name description timezone and creation date by providing organization ID project ID and authentication token.

Projects > Get all projects

The GET endpoint retrieves all Manufactory projects for an organization by providing the org_id and authentication token in the header which returns project details like IDs names descriptions and timezones.

Projects > Reset project key

A POST request to reset a project’s key requires an access token and returns project details including the new key along with basic information like name timezone and creation date.