Prepare a managed definition creation without creating a definition or provider resources.
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://example.com/api/workspace/admin/entity-semantic-operations/create"), Headers = { { "Authorization", "Bearer <token>" }, }, Content = new StringContent("{ \"OperationId\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"Definition\": { \"Name\": \"example\", \"DisplayNameSingular\": \"example\", \"DisplayNamePlural\": \"example\", \"Description\": \"example\", \"IsReadOnly\": true, \"DisabledOperations\": 0, \"SemanticType\": \"example\" }, \"ProviderParameters\": \"example\" }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}const url = 'https://example.com/api/workspace/admin/entity-semantic-operations/create';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"OperationId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","Definition":{"Name":"example","DisplayNameSingular":"example","DisplayNamePlural":"example","Description":"example","IsReadOnly":true,"DisabledOperations":0,"SemanticType":"example"},"ProviderParameters":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/workspace/admin/entity-semantic-operations/create \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "OperationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "Definition": { "Name": "example", "DisplayNameSingular": "example", "DisplayNamePlural": "example", "Description": "example", "IsReadOnly": true, "DisabledOperations": 0, "SemanticType": "example" }, "ProviderParameters": "example" }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.
Request Body
Section titled “Request Body”Managed creation with caller-owned retry identity and provider-validated parameters.
object
Stable idempotency identity reused for every retry of this exact request.
Request payload to create an entity definition.
object
Internal entity name.
User-facing singular name.
User-facing plural name.
Optional entity description.
Whether runtime writes should be blocked for this entity.
Registered Data specialization. Generic preserves ordinary atomic creation.
Provider-owned input. Never include credentials or authorization grants.
Managed creation with caller-owned retry identity and provider-validated parameters.
object
Stable idempotency identity reused for every retry of this exact request.
Request payload to create an entity definition.
object
Internal entity name.
User-facing singular name.
User-facing plural name.
Optional entity description.
Whether runtime writes should be blocked for this entity.
Registered Data specialization. Generic preserves ordinary atomic creation.
Provider-owned input. Never include credentials or authorization grants.
Managed creation with caller-owned retry identity and provider-validated parameters.
object
Stable idempotency identity reused for every retry of this exact request.
Request payload to create an entity definition.
object
Internal entity name.
User-facing singular name.
User-facing plural name.
Optional entity description.
Whether runtime writes should be blocked for this entity.
Registered Data specialization. Generic preserves ordinary atomic creation.
Provider-owned input. Never include credentials or authorization grants.
Responses
Section titled “Responses”OK
object
Safe administration status. Provider plans, checkpoints and input payloads are never exposed here.
object
Definition resource operation; never a replacement for Entity Instance mutations.
Completed means provider resources are ready, not that the definition is active/deleted. Only Finalized or Compensated releases the unfinished-operation reservation.
object
object
object
object
Example
{ "Data": { "Kind": 0, "State": 0 }, "Errors": [ { "Type": 0, "Severity": 0 } ], "Warnings": [ { "Type": 0, "Severity": 0 } ]}Bad Request
object
Safe administration status. Provider plans, checkpoints and input payloads are never exposed here.
object
Definition resource operation; never a replacement for Entity Instance mutations.
Completed means provider resources are ready, not that the definition is active/deleted. Only Finalized or Compensated releases the unfinished-operation reservation.
object
object
object
object
Example
{ "Data": { "Kind": 0, "State": 0 }, "Errors": [ { "Type": 0, "Severity": 0 } ], "Warnings": [ { "Type": 0, "Severity": 0 } ]}Forbidden
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Conflict
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}