1. Items
Enspace
  • Introduction
  • Authentication
  • Concepts
  • First Steps
  • Workspaces
    • Types
      • Fields
        • List Fields
        • Create Field
        • Get Field
        • Field Updated
        • Delete Field
      • Items
        • List Items
          GET
        • Create Item
          POST
        • Count Items
          GET
        • Get Item
          GET
        • Update Item
          PUT
        • Delete item
          DELETE
      • Flows
        • Stages
          • Tasks
            • List Tasks
            • Get specific Task
            • New Task
          • List Stages
          • Get specific Stage
        • List Flows
        • Get specific Flow
      • Forms
        • List Form
        • Get specific Form
        • List Form Create
      • List Types
        GET
      • Count Types
        GET
      • Get specific Type
        GET
      • Create Type
        POST
      • Update Type
        PUT
      • Delete Type
        DELETE
    • Members
      • List Members
      • Count Members
      • Get Member
      • New Member
      • Update Member
      • Remove Member
    • Roles
      • List roles
      • Create role
      • Count roles
      • Get specific role
      • Update role
      • Delete role
      • List Role Permissions
      • Add Permission to Role
      • Remove Role Permission
    • Member Groups
      • List groups
      • New group
      • Get group
      • Update group
      • Delete group
      • Add Users
      • Remove Users
    • Quick Tasks
      • List Quick Tasks
      • Count Quick Tasks
      • Get Quick Task
      • Delete Quick Task
      • Update Quick Task
      • New Quick Task
    • Integrations
      • CertiSign
      • Docusign
      • D4Sign
      • Clicksign
      • Adobe Sign
      • Whatsapp Twilio
      • SendGrid
      • OpenAi
      • Integration
      • New Integration
    • Schedule Tasks
      • List Schedule Tasks
      • Get specify Schedule Task
    • List Workspaces
      GET
    • Workspace Context
      GET
    • New Workspace
      POST
    • Leave the workspace
      POST
    • Workspace Statistics
      GET
    • Workspace Deletion Preview
      GET
    • Delete Workspace
      DELETE
  • User
    • Request Log
    • List API Keys
  • Schemas
    • Schemas
      • Members
        • MemberUpdate
        • MemberCreate
        • Member
      • Roles
        • Role
        • RoleCreate
        • RoleUpdate
      • MemberGroups
        • MemberGroup
        • MemberGroupCreate
        • MemberGroupUpdate
      • Types
        • Type
        • TypeInput
        • TypeDetail
      • Items
        • Item
        • ItemInput
      • Workspace
        • WorkspaceContext
        • WorkspaceStats
        • Workspace
        • WorkspaceCreate
        • WorkspaceUpdate
      • Tasks
        • Tasks
      • Flow
        • Flow
      • Stages
        • Stage
      • Forms
        • Forms
      • Integrations
        • Integrations
      • User
      • RequestLog
      • UserApiKey
      • SuccessResponse
      • ErrorResponse
      • Field
      • FieldInput
      • Permission
      • PermissionInput
    • Response
      • BadRequest
      • Unauthorized
      • Forbidden
      • NotFound
      • ServerError
    • Position
    • Dimensions
    • NodeType
    • WorkflowNodeDefinition
    • WorkflowEdgeDefinition
    • TaskFields
    • TriggerNodeData
    • CronConfig
    • StartNodeData
    • EndNodeData
    • ApprovalNodeData
    • TaskNodeData
    • FormNodeData
    • EmailNodeData
    • ConditionalsNodeData
    • ConditionalRule
    • ConditionalsNodeData_examples_inline
    • RouteNodeData
    • RouteRule
    • MergeNodeData
    • CrudNodeData
    • HttpNodeData
    • Error
    • AiNodeData
    • ComparisonNotificationNodeData
    • Workflow
    • WorkflowCreate
    • WorkflowUpdate
    • WorkflowExecution
    • NodeExecution
  1. Items

Create Item

Develop Env
https://api-develop.enspace.io
Develop Env
https://api-develop.enspace.io
POST
https://api-develop.enspace.io
/ws/types/{slug}/items
Maintainer:Julio Cordeiro

Create Item#

Creates a new item for a specific Type in the current workspace.

Parameters#

slug (path) - Unique slug of the Type.

Request Body#

data (required, object): key/value payload mapped by field refId of the selected Type.
form (optional, string): form identification ("default" for default form).
options (optional, object): supports keep_as_draft and version_name.
ignore_triggers (optional, boolean)
isDraft (optional, boolean)
The structure of data depends on the fields configured for that Type.

Request Example#

{
  "data": {
    "name": "iPhone 15",
    "price": 4999.99,
    "category": "electronics",
    "available": true
  }
}

Common Errors#

400 Bad Request: Missing required fields, invalid field types, or validation failure.
401 Unauthorized: Missing/invalid auth token or missing permission types::{slug}::create.
403 Forbidden: User is not a member of the workspace.
404 Not Found: Type not found.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
API Key
Add parameter in header
en-workspace
Example:
en-workspace: ********************
or
Path Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Item successfully created.
Body

🟠400Invalid request
🟠401Unauthorized
🟠404Record not found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-develop.enspace.io/ws/types/impostos/items' \
--header 'x-api-key: <api-key>' \
--header 'en-workspace: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "form": "default",
    "data": {
        "product_name": "Notebook Pro",
        "price": 4999.9,
        "active": true
    },
    "options": {
        "keep_as_draft": false
    }
}'
Response Response Example
200 - Success
"error": {
    "status": 400,
    "name": "ValidationError",
    "message": "Invalid data",
    "details": [
        {
            "field": "name",
            "message": "Name is required"
        }
    ]
}
}
Previous
List Items
Next
Count Items
Built with