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

Projects can be updated via a PUT request by providing authentication, organization ID, project ID, and optional fields like name, description, and timezone preferences.

Projects > Get a project

The GET endpoint retrieves project details including organization ID, project ID, name, description, timezone, creation timestamp, and project key when authenticated with a Manufactory access token.

Projects > Get all projects

The GET /projects/[org_id] endpoint retrieves a list of Manufactory projects with their details including project ID, name, description, timezone, and creation timestamp when authenticated with a valid access token.

Projects > Reset project key

Project keys can be reset via a POST request that requires authentication with a Manufactory access token and returns updated project details including the new key.