POST api/v1/Commitments

Creates a new commitment

Request Information

URI Parameters

Name	Description	Type	Additional information
fields	Use this to only return the data fields you're interested in. Field names not found are ignored and no error is thrown. If no fields are found then the full object is returned.	Collection of string	None.
suppressResponseCodes	Some applications do wonky things if error codes are used. Use this to force 200s to always return.	boolean	None.
APIKey	This is your unique key that identifies you as the developer of this app. Required for all calls.	string	None.
APIToken	This is the user's session token generated when you authenticate the user	string	None.

Body Parameters

The values for the new commitment

NewCommitment

Name	Description	Type	Additional information
Text	The text body of the commitment	string	None.
PeriodStartDate	The week the commitment is for	date	None.
GoalID	The goal the commitment is tied to	globally unique identifier	None.
TeamID	The team this commitment is for	globally unique identifier	None.
UserID	The user responsible for this commitment	globally unique identifier	None.

Request Formats

application/json, text/json

Sample:

{
  "Text": "sample string 1",
  "PeriodStartDate": "2024-05-19T11:55:40.0258952-04:00",
  "GoalID": "d32f89a8-f87b-4010-843f-f6ae794e9331",
  "TeamID": "e533d268-1701-4c84-acc3-f0f2479a19d8",
  "UserID": "12630162-3b43-43cd-bb36-15b5d892a5e7"
}

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Commitment

Name	Description	Type	Additional information
ID	The commitment's ID	globally unique identifier	None.
Text	The text body of the commitment	string	None.
Completed	Whether the user has completed the commitment	boolean	None.
PeriodStartDate	The week the commitment is for	date	None.
GoalID	The goal the commitment is tied to	globally unique identifier	None.
TeamID	The team this commitment is a part of (a user can be on multiple teams)	globally unique identifier	None.
UserID	The user this commitment is assigned to	globally unique identifier	None.

Response Formats

application/json, text/json

Sample:

{
  "ID": "2560945f-389a-4470-b4e6-24f8324d4d37",
  "Text": "sample string 2",
  "Completed": true,
  "PeriodStartDate": "2024-05-19T11:55:40.1040581-04:00",
  "GoalID": "d5b40d9d-a18b-4865-97e5-9beb0d30c60b",
  "TeamID": "a643e2d7-7042-42f5-a4f1-007b4ffa5437",
  "UserID": "70186d91-b994-401c-8cad-80db308b6b06"
}