POST States

Back to endpoints

POST States

Creates a new state.

Request Information

URI Parameters

None.

Body Parameters

The state to create. StateId should not be filled in.

State

Name	Type	Additional information
StateId	globally unique identifier	None.
Asset	Asset	None.
EffectiveDate	date	None.
StateType	StateType	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:

{
  "StateId": "652f8a54-90e9-421d-941f-7b47924c6bf2",
  "Asset": {
    "AssetId": "91706c8e-c4ba-4a50-86db-1b96f7e8f99d",
    "Name": "sample string 1",
    "Description": "sample string 2",
    "DisplayOrder": 1,
    "AssetType": {
      "AssetTypeId": "de3fd807-118a-4ae6-bab5-b0768a11ec2d",
      "Name": "sample string 1",
      "Description": "sample string 2",
      "IsWell": true,
      "DisplayColor": "sample string 4",
      "SourceSystemId": "sample string 5",
      "CompanyId": "a5ca1b86-5f68-4593-98fc-7b5b993d9491",
      "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
      "CreateUser": "sample string 7",
      "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
      "LastModifiedUser": "sample string 8"
    },
    "AssetGroup": {
      "AssetGroupId": "490ac812-a9a3-480a-aa65-465162e4ead5",
      "Name": "sample string 1",
      "Description": "sample string 2",
      "ParentGroup": null,
      "DisplayOrder": 1,
      "FormValueNeededDate": "2026-04-21T11:52:17.6498969-07:00",
      "MeasurementValueNeededDate": "2026-04-21T11:52:17.6498969-07:00",
      "SourceSystemId": "sample string 3",
      "CompanyId": "33eb7f0a-de01-4063-b188-03579c783aef",
      "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
      "CreateUser": "sample string 5",
      "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
      "LastModifiedUser": "sample string 6"
    },
    "ParentAsset": null,
    "Location": "sample string 3",
    "Barcode": {
      "Format": 0,
      "Code": "sample string 1"
    },
    "Status": {
      "StatusId": "a120b222-9e45-4845-abea-74ca2f2cb889",
      "EffectiveDate": "2026-04-21T11:52:17.6498969-07:00",
      "StatusType": {
        "StatusTypeId": "67466bbe-d423-40b4-aaad-a5affb3ddabf",
        "Name": "sample string 1",
        "IsProducing": true,
        "IsInjecting": true,
        "AssetType": {
          "AssetTypeId": "de3fd807-118a-4ae6-bab5-b0768a11ec2d",
          "Name": "sample string 1",
          "Description": "sample string 2",
          "IsWell": true,
          "DisplayColor": "sample string 4",
          "SourceSystemId": "sample string 5",
          "CompanyId": "a5ca1b86-5f68-4593-98fc-7b5b993d9491",
          "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
          "CreateUser": "sample string 7",
          "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
          "LastModifiedUser": "sample string 8"
        },
        "SourceSystemId": "sample string 4",
        "CompanyId": "8d245445-8489-4cff-8b1b-2b8e4788a296",
        "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
        "CreateUser": "sample string 6",
        "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
        "LastModifiedUser": "sample string 7"
      },
      "SourceSystemId": "sample string 1",
      "CompanyId": "c26bcbb5-3991-4c34-afdc-36b9907257eb",
      "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
      "CreateUser": "sample string 3",
      "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
      "LastModifiedUser": "sample string 4"
    },
    "WellPurpose": {
      "WellPurposeId": "0f583f12-0628-4d6b-a1cc-fb55c1dde6ee",
      "EffectiveDate": "2026-04-21T11:52:17.6498969-07:00",
      "WellPurposeType": {
        "WellPurposeTypeId": "3ff121f3-b9b7-48b3-a400-14f43fd758d6",
        "IsProducer": true,
        "IsInjector": true,
        "Name": "sample string 3",
        "SourceSystemId": "sample string 4",
        "CompanyId": "54939770-dad9-4b14-b595-cb9ab70b2422",
        "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
        "CreateUser": "sample string 6",
        "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
        "LastModifiedUser": "sample string 7"
      },
      "SourceSystemId": "sample string 1",
      "CompanyId": "dc8926ac-0af3-4bec-96cf-3c015500f1f4",
      "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
      "CreateUser": "sample string 3",
      "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
      "LastModifiedUser": "sample string 4"
    },
    "FormValueNeededDate": "2026-04-21T11:52:17.6498969-07:00",
    "MeasurementValueNeededDate": "2026-04-21T11:52:17.6498969-07:00",
    "HasChildren": true,
    "SourceSystemId": "sample string 5",
    "CompanyId": "141aea5d-4c9f-420b-84e4-3e6cfe94a86e",
    "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
    "CreateUser": "sample string 7",
    "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
    "LastModifiedUser": "sample string 8"
  },
  "EffectiveDate": "2026-04-21T11:52:17.6498969-07:00",
  "StateType": {
    "StateTypeId": "3a44dc36-ceba-4ee1-ad45-8f26b0fdd004",
    "Name": "sample string 1",
    "IsOperational": true,
    "AssetType": {
      "AssetTypeId": "de3fd807-118a-4ae6-bab5-b0768a11ec2d",
      "Name": "sample string 1",
      "Description": "sample string 2",
      "IsWell": true,
      "DisplayColor": "sample string 4",
      "SourceSystemId": "sample string 5",
      "CompanyId": "a5ca1b86-5f68-4593-98fc-7b5b993d9491",
      "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
      "CreateUser": "sample string 7",
      "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
      "LastModifiedUser": "sample string 8"
    },
    "SourceSystemId": "sample string 3",
    "CompanyId": "c7d56d86-8fcd-4302-849b-b7625ee70ce3",
    "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
    "CreateUser": "sample string 5",
    "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
    "LastModifiedUser": "sample string 6"
  },
  "SourceSystemId": "sample string 1",
  "CompanyId": "ce890918-3a24-43c9-9a56-7207eadcabc2",
  "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
  "CreateUser": "sample string 3",
  "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
  "LastModifiedUser": "sample string 4"
}

Response Information

Resource Description

On success, the created state.

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

Response Formats

application/json, text/json

Sample:

{
  "Data": {
    "StateId": "b5232e65-edc4-42dd-a206-05291af95015",
    "Asset": {
      "AssetId": "471cbc60-0cc4-40da-8576-91724ca8858c",
      "Name": "sample string 1",
      "Description": "sample string 2",
      "DisplayOrder": 1,
      "AssetType": {
        "AssetTypeId": "c73674fa-6393-4e6f-ba9b-6c85e7a8c1db",
        "Name": "sample string 1",
        "Description": "sample string 2",
        "IsWell": true,
        "DisplayColor": "sample string 4",
        "SourceSystemId": "sample string 5",
        "CompanyId": "28dc39ef-b010-4d6e-a2e2-0ee0de16a605",
        "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
        "CreateUser": "sample string 7",
        "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
        "LastModifiedUser": "sample string 8"
      },
      "AssetGroup": {
        "AssetGroupId": "a6e072d6-39f7-4eb1-b8f3-8d6058507ab1",
        "Name": "sample string 1",
        "Description": "sample string 2",
        "ParentGroup": null,
        "DisplayOrder": 1,
        "FormValueNeededDate": "2026-04-21T11:52:17.6498969-07:00",
        "MeasurementValueNeededDate": "2026-04-21T11:52:17.6498969-07:00",
        "SourceSystemId": "sample string 3",
        "CompanyId": "2f711b31-1296-499b-93cb-1e928416b055",
        "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
        "CreateUser": "sample string 5",
        "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
        "LastModifiedUser": "sample string 6"
      },
      "ParentAsset": null,
      "Location": "sample string 3",
      "Barcode": {
        "Format": 0,
        "Code": "sample string 1"
      },
      "Status": {
        "StatusId": "6a2cd0aa-e235-4ed3-b61d-a93fa28d375d",
        "EffectiveDate": "2026-04-21T11:52:17.6498969-07:00",
        "StatusType": {
          "StatusTypeId": "52f6675f-89cf-4160-b13c-2b42cb7e545d",
          "Name": "sample string 1",
          "IsProducing": true,
          "IsInjecting": true,
          "AssetType": {
            "AssetTypeId": "c73674fa-6393-4e6f-ba9b-6c85e7a8c1db",
            "Name": "sample string 1",
            "Description": "sample string 2",
            "IsWell": true,
            "DisplayColor": "sample string 4",
            "SourceSystemId": "sample string 5",
            "CompanyId": "28dc39ef-b010-4d6e-a2e2-0ee0de16a605",
            "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
            "CreateUser": "sample string 7",
            "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
            "LastModifiedUser": "sample string 8"
          },
          "SourceSystemId": "sample string 4",
          "CompanyId": "1fa13d30-eabc-4bb5-894b-bd421bcdecbd",
          "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
          "CreateUser": "sample string 6",
          "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
          "LastModifiedUser": "sample string 7"
        },
        "SourceSystemId": "sample string 1",
        "CompanyId": "367fe849-d46c-455d-99c9-629d831e3f58",
        "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
        "CreateUser": "sample string 3",
        "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
        "LastModifiedUser": "sample string 4"
      },
      "WellPurpose": {
        "WellPurposeId": "4396b54a-df4b-4274-814a-288adf46f317",
        "EffectiveDate": "2026-04-21T11:52:17.6498969-07:00",
        "WellPurposeType": {
          "WellPurposeTypeId": "776bcb1c-f2c3-4f16-9f8c-d5ff0c04cfc5",
          "IsProducer": true,
          "IsInjector": true,
          "Name": "sample string 3",
          "SourceSystemId": "sample string 4",
          "CompanyId": "0b07a5cb-0ae1-432a-8ea7-28bc13cfc9c8",
          "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
          "CreateUser": "sample string 6",
          "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
          "LastModifiedUser": "sample string 7"
        },
        "SourceSystemId": "sample string 1",
        "CompanyId": "d3b4fb79-494c-4102-9ab0-bc705ed8a0b7",
        "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
        "CreateUser": "sample string 3",
        "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
        "LastModifiedUser": "sample string 4"
      },
      "FormValueNeededDate": "2026-04-21T11:52:17.6498969-07:00",
      "MeasurementValueNeededDate": "2026-04-21T11:52:17.6498969-07:00",
      "HasChildren": true,
      "SourceSystemId": "sample string 5",
      "CompanyId": "ef90d022-cce0-4241-b597-f62015460a62",
      "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
      "CreateUser": "sample string 7",
      "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
      "LastModifiedUser": "sample string 8"
    },
    "EffectiveDate": "2026-04-21T11:52:17.6498969-07:00",
    "StateType": {
      "StateTypeId": "cad53a88-f315-43fe-ba2f-671373d6885b",
      "Name": "sample string 1",
      "IsOperational": true,
      "AssetType": {
        "AssetTypeId": "c73674fa-6393-4e6f-ba9b-6c85e7a8c1db",
        "Name": "sample string 1",
        "Description": "sample string 2",
        "IsWell": true,
        "DisplayColor": "sample string 4",
        "SourceSystemId": "sample string 5",
        "CompanyId": "28dc39ef-b010-4d6e-a2e2-0ee0de16a605",
        "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
        "CreateUser": "sample string 7",
        "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
        "LastModifiedUser": "sample string 8"
      },
      "SourceSystemId": "sample string 3",
      "CompanyId": "abd68610-b2aa-40c7-aa34-8dc503c8c72f",
      "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
      "CreateUser": "sample string 5",
      "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
      "LastModifiedUser": "sample string 6"
    },
    "SourceSystemId": "sample string 1",
    "CompanyId": "46e65f66-1786-4abe-835c-1803e4764d5b",
    "CreateDate": "2026-04-21T11:52:17.6498969-07:00",
    "CreateUser": "sample string 3",
    "LastModifiedDate": "2026-04-21T11:52:17.6498969-07:00",
    "LastModifiedUser": "sample string 4"
  },
  "Total": 1,
  "Message": "sample string 1"
}