POST WellPurposes

Back to endpoints

POST WellPurposes

Creates a new well purpose.

Request Information

URI Parameters

None.

Body Parameters

Well purpose to be created. WellPurposeId should not be filled in.

WellPurpose

Name	Type	Additional information
WellPurposeId	globally unique identifier	None.
Asset	Asset	None.
EffectiveDate	date	None.
WellPurposeType	WellPurposeType	None.
SourceSystemId	string	None.
CompanyId	globally unique identifier	None.
CreateDate	date	None.
CreateUser	string	None.
LastModifiedDate	date	None.
LastModifiedUser	string	None.

Request Formats

application/json, text/json

Sample:

{
  "WellPurposeId": "3ee8a6dd-2a9b-46ad-b3c4-f3b2f44d79c8",
  "Asset": {
    "AssetId": "bb04c887-ecc4-4aa1-bc42-5105fb0d2199",
    "Name": "sample string 1",
    "Description": "sample string 2",
    "DisplayOrder": 1,
    "AssetType": {
      "AssetTypeId": "a3d0fd2c-d199-4bf3-955f-4a6c57546558",
      "Name": "sample string 1",
      "Description": "sample string 2",
      "IsWell": true,
      "DisplayColor": "sample string 4",
      "SourceSystemId": "sample string 5",
      "CompanyId": "b26ac1a1-36da-40f2-a28f-79ce74956b12",
      "CreateDate": "2026-04-17T20:25:25.84773-07:00",
      "CreateUser": "sample string 7",
      "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
      "LastModifiedUser": "sample string 8"
    },
    "AssetGroup": {
      "AssetGroupId": "bf9fdb9c-2276-4ad9-b715-985551f78a9e",
      "Name": "sample string 1",
      "Description": "sample string 2",
      "ParentGroup": null,
      "DisplayOrder": 1,
      "FormValueNeededDate": "2026-04-17T20:25:25.84773-07:00",
      "MeasurementValueNeededDate": "2026-04-17T20:25:25.84773-07:00",
      "SourceSystemId": "sample string 3",
      "CompanyId": "e13840e0-c49a-4ec2-9503-a908b0f76592",
      "CreateDate": "2026-04-17T20:25:25.84773-07:00",
      "CreateUser": "sample string 5",
      "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
      "LastModifiedUser": "sample string 6"
    },
    "ParentAsset": null,
    "Location": "sample string 3",
    "Barcode": {
      "Format": 0,
      "Code": "sample string 1"
    },
    "State": {
      "StateId": "ebf83e51-eb03-4acb-9c58-b93ad1545ded",
      "EffectiveDate": "2026-04-17T20:25:25.84773-07:00",
      "StateType": {
        "StateTypeId": "8bf2454c-fc16-4df6-b33a-07dd75820fe8",
        "Name": "sample string 1",
        "IsOperational": true,
        "AssetType": {
          "AssetTypeId": "a3d0fd2c-d199-4bf3-955f-4a6c57546558",
          "Name": "sample string 1",
          "Description": "sample string 2",
          "IsWell": true,
          "DisplayColor": "sample string 4",
          "SourceSystemId": "sample string 5",
          "CompanyId": "b26ac1a1-36da-40f2-a28f-79ce74956b12",
          "CreateDate": "2026-04-17T20:25:25.84773-07:00",
          "CreateUser": "sample string 7",
          "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
          "LastModifiedUser": "sample string 8"
        },
        "SourceSystemId": "sample string 3",
        "CompanyId": "8a9c29ea-ea35-4a12-b308-4f358e4dca43",
        "CreateDate": "2026-04-17T20:25:25.84773-07:00",
        "CreateUser": "sample string 5",
        "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
        "LastModifiedUser": "sample string 6"
      },
      "SourceSystemId": "sample string 1",
      "CompanyId": "d35b1dac-abb8-4df8-823a-a5e610ef433b",
      "CreateDate": "2026-04-17T20:25:25.84773-07:00",
      "CreateUser": "sample string 3",
      "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
      "LastModifiedUser": "sample string 4"
    },
    "Status": {
      "StatusId": "a1c4c4d7-40b1-48ef-9b6c-e505783e0838",
      "EffectiveDate": "2026-04-17T20:25:25.84773-07:00",
      "StatusType": {
        "StatusTypeId": "71c83d8e-e60c-4c8a-875e-c11e63bb6631",
        "Name": "sample string 1",
        "IsProducing": true,
        "IsInjecting": true,
        "AssetType": {
          "AssetTypeId": "a3d0fd2c-d199-4bf3-955f-4a6c57546558",
          "Name": "sample string 1",
          "Description": "sample string 2",
          "IsWell": true,
          "DisplayColor": "sample string 4",
          "SourceSystemId": "sample string 5",
          "CompanyId": "b26ac1a1-36da-40f2-a28f-79ce74956b12",
          "CreateDate": "2026-04-17T20:25:25.84773-07:00",
          "CreateUser": "sample string 7",
          "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
          "LastModifiedUser": "sample string 8"
        },
        "SourceSystemId": "sample string 4",
        "CompanyId": "b05c543d-68f7-4551-ae95-361f4693ca42",
        "CreateDate": "2026-04-17T20:25:25.84773-07:00",
        "CreateUser": "sample string 6",
        "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
        "LastModifiedUser": "sample string 7"
      },
      "SourceSystemId": "sample string 1",
      "CompanyId": "8931456a-f317-4f55-b376-1ab8df4499e9",
      "CreateDate": "2026-04-17T20:25:25.84773-07:00",
      "CreateUser": "sample string 3",
      "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
      "LastModifiedUser": "sample string 4"
    },
    "FormValueNeededDate": "2026-04-17T20:25:25.84773-07:00",
    "MeasurementValueNeededDate": "2026-04-17T20:25:25.84773-07:00",
    "HasChildren": true,
    "SourceSystemId": "sample string 5",
    "CompanyId": "1d68db19-949b-466f-893a-5edc9805aea4",
    "CreateDate": "2026-04-17T20:25:25.84773-07:00",
    "CreateUser": "sample string 7",
    "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
    "LastModifiedUser": "sample string 8"
  },
  "EffectiveDate": "2026-04-17T20:25:25.84773-07:00",
  "WellPurposeType": {
    "WellPurposeTypeId": "2fdbf9b8-0ae9-4533-a2d0-36913d44a9d1",
    "IsProducer": true,
    "IsInjector": true,
    "Name": "sample string 3",
    "SourceSystemId": "sample string 4",
    "CompanyId": "1caa289b-e9f2-46ca-8d1e-457605cde910",
    "CreateDate": "2026-04-17T20:25:25.84773-07:00",
    "CreateUser": "sample string 6",
    "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
    "LastModifiedUser": "sample string 7"
  },
  "SourceSystemId": "sample string 1",
  "CompanyId": "9c13fc60-3ee9-4db2-8045-908e62a6e72a",
  "CreateDate": "2026-04-17T20:25:25.84773-07:00",
  "CreateUser": "sample string 3",
  "LastModifiedDate": "2026-04-17T20:25:25.84773-07:00",
  "LastModifiedUser": "sample string 4"
}

Response Information

Resource Description

On success, the created well purpose.

Name	Type	Additional information
Data	WellPurpose	None.
Total	integer	None.
Message	string	None.

Response Formats

application/json, text/json

Sample:

{
  "Data": {
    "WellPurposeId": "e02ed0e7-753f-43c1-8146-33368b644ab6",
    "Asset": {
      "AssetId": "f871795d-a525-41c7-9b07-cd25527edd90",
      "Name": "sample string 1",
      "Description": "sample string 2",
      "DisplayOrder": 1,
      "AssetType": {
        "AssetTypeId": "0e8ca2b0-d001-43c0-979f-a080d6d18ea8",
        "Name": "sample string 1",
        "Description": "sample string 2",
        "IsWell": true,
        "DisplayColor": "sample string 4",
        "SourceSystemId": "sample string 5",
        "CompanyId": "f8860d4f-d7f0-4977-a11c-ec69a88b0ac6",
        "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
        "CreateUser": "sample string 7",
        "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
        "LastModifiedUser": "sample string 8"
      },
      "AssetGroup": {
        "AssetGroupId": "16cf863a-8047-4790-8eac-a23affe157f9",
        "Name": "sample string 1",
        "Description": "sample string 2",
        "ParentGroup": null,
        "DisplayOrder": 1,
        "FormValueNeededDate": "2026-04-17T20:25:26.1601614-07:00",
        "MeasurementValueNeededDate": "2026-04-17T20:25:26.1601614-07:00",
        "SourceSystemId": "sample string 3",
        "CompanyId": "24b89e8b-8e22-4ed0-af3b-1d869e47b36c",
        "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
        "CreateUser": "sample string 5",
        "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
        "LastModifiedUser": "sample string 6"
      },
      "ParentAsset": null,
      "Location": "sample string 3",
      "Barcode": {
        "Format": 0,
        "Code": "sample string 1"
      },
      "State": {
        "StateId": "d2da0db7-6e27-49e8-84f9-c60ace3461cd",
        "EffectiveDate": "2026-04-17T20:25:26.1601614-07:00",
        "StateType": {
          "StateTypeId": "a92267a9-f28e-4fec-9e31-660b99033a90",
          "Name": "sample string 1",
          "IsOperational": true,
          "AssetType": {
            "AssetTypeId": "0e8ca2b0-d001-43c0-979f-a080d6d18ea8",
            "Name": "sample string 1",
            "Description": "sample string 2",
            "IsWell": true,
            "DisplayColor": "sample string 4",
            "SourceSystemId": "sample string 5",
            "CompanyId": "f8860d4f-d7f0-4977-a11c-ec69a88b0ac6",
            "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
            "CreateUser": "sample string 7",
            "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
            "LastModifiedUser": "sample string 8"
          },
          "SourceSystemId": "sample string 3",
          "CompanyId": "8c210c3e-e641-43cf-9b71-56bb646445b0",
          "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
          "CreateUser": "sample string 5",
          "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
          "LastModifiedUser": "sample string 6"
        },
        "SourceSystemId": "sample string 1",
        "CompanyId": "6e333ab6-5343-4724-ab97-43cf29b8d847",
        "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
        "CreateUser": "sample string 3",
        "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
        "LastModifiedUser": "sample string 4"
      },
      "Status": {
        "StatusId": "967f9231-894f-493b-a491-0d622539c8d8",
        "EffectiveDate": "2026-04-17T20:25:26.1601614-07:00",
        "StatusType": {
          "StatusTypeId": "1415a110-7bff-474c-80a8-94bbb3d8a13a",
          "Name": "sample string 1",
          "IsProducing": true,
          "IsInjecting": true,
          "AssetType": {
            "AssetTypeId": "0e8ca2b0-d001-43c0-979f-a080d6d18ea8",
            "Name": "sample string 1",
            "Description": "sample string 2",
            "IsWell": true,
            "DisplayColor": "sample string 4",
            "SourceSystemId": "sample string 5",
            "CompanyId": "f8860d4f-d7f0-4977-a11c-ec69a88b0ac6",
            "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
            "CreateUser": "sample string 7",
            "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
            "LastModifiedUser": "sample string 8"
          },
          "SourceSystemId": "sample string 4",
          "CompanyId": "74b5f234-6701-4b15-b6ac-7a420998b0a9",
          "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
          "CreateUser": "sample string 6",
          "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
          "LastModifiedUser": "sample string 7"
        },
        "SourceSystemId": "sample string 1",
        "CompanyId": "dd64d196-9b19-4bd6-8f53-3f839a89bc11",
        "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
        "CreateUser": "sample string 3",
        "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
        "LastModifiedUser": "sample string 4"
      },
      "FormValueNeededDate": "2026-04-17T20:25:26.1601614-07:00",
      "MeasurementValueNeededDate": "2026-04-17T20:25:26.1601614-07:00",
      "HasChildren": true,
      "SourceSystemId": "sample string 5",
      "CompanyId": "d66ec56e-7152-4f73-b653-46a5b3ccef25",
      "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
      "CreateUser": "sample string 7",
      "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
      "LastModifiedUser": "sample string 8"
    },
    "EffectiveDate": "2026-04-17T20:25:26.1601614-07:00",
    "WellPurposeType": {
      "WellPurposeTypeId": "97987394-353f-43d2-ae16-c2a3b70010ac",
      "IsProducer": true,
      "IsInjector": true,
      "Name": "sample string 3",
      "SourceSystemId": "sample string 4",
      "CompanyId": "1789b4e0-9788-4c48-bc1a-48e3f83b7554",
      "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
      "CreateUser": "sample string 6",
      "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
      "LastModifiedUser": "sample string 7"
    },
    "SourceSystemId": "sample string 1",
    "CompanyId": "de4edfb8-09aa-4519-8afb-e6ca425fb146",
    "CreateDate": "2026-04-17T20:25:26.1601614-07:00",
    "CreateUser": "sample string 3",
    "LastModifiedDate": "2026-04-17T20:25:26.1601614-07:00",
    "LastModifiedUser": "sample string 4"
  },
  "Total": 1,
  "Message": "sample string 1"
}