Skip to content
Micro micro
Go to Micro
API Reference
Prism
Objects
Identities

Create object

client.Prism.Objects.Identities.New(ctx, params) (*PrismObjectIdentityNewResponse, error)
POST/v2/prism/{teamId}/identity

Create object

ParametersExpand Collapse
params PrismObjectIdentityNewParams
TeamID param.Field[string]Optional

Path param

formatuuid
PrismObjectProperties param.Field[PrismObjectProperties]

Body param

IdempotencyKey param.Field[string]Optional

Header param: A unique key (UUID or any opaque string up to 255 chars) for an authenticated POST, PUT, or PATCH request. The server retains the initial claim for 24 hours and replays a completed non-5xx response only when the method, path, and request body all match. Reusing a non-expired key with a different method, path, or body returns 409 idempotency_key_mismatch; reusing it after expiry returns 409 idempotency_key_stale, so use a new key. Replays include the idempotent-replay: true response header.

minLength1
maxLength255
ReturnsExpand Collapse
type PrismObjectIdentityNewResponse struct{…}

Object returned by reads (get/create/patch/restore). id is always present.

ID string
formatuuid
Default map[string, unknown]Optional

Properties keyed by property slug.

List unknownOptional

Create object

package main

import (
  "context"
  "fmt"

  "github.com/micro-so/micro-sdk-go"
  "github.com/micro-so/micro-sdk-go/option"
)

func main() {
  client := micro.NewClient(
    option.WithAPIKey("My API Key"),
    option.WithTeamID("My Team ID"),
  )
  identity, err := client.Prism.Objects.Identities.New(context.TODO(), micro.PrismObjectIdentityNewParams{
    PrismObjectProperties: micro.PrismObjectPropertiesParam{

    },
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", identity.ID)
}

{
  "id": "11111111-1111-4111-8111-111111111111",
  "default": {
    "full_name": "Sarah Chen",
    "email": "sarah@example.com",
    "title": "Partner",
    "organization": "Acme Ventures"
  }
}
{
  "id": "22222222-2222-4222-8222-222222222222",
  "default": {
    "name": "Acme Ventures",
    "domain": "example.com",
    "industry": "Venture Capital"
  }
}
{
  "id": "33333333-3333-4333-8333-333333333333",
  "default": {
    "name": "Acme Ventures — Series A",
    "amount": 2500000,
    "stage": "negotiation",
    "organization": "Acme Ventures"
  }
}
{
  "id": "44444444-4444-4444-8444-444444444444",
  "default": {
    "name": "Follow up with Sarah Chen",
    "status": "open",
    "due_date": "2026-08-06",
    "contact": "Sarah Chen"
  }
}
{
  "id": "55555555-5555-4555-8555-555555555555",
  "default": {
    "name": "Acme Ventures — Series A notes",
    "content": "Sarah Chen is coordinating diligence for the Series A.",
    "organization": "Acme Ventures"
  }
}
Returns Examples
{
  "id": "11111111-1111-4111-8111-111111111111",
  "default": {
    "full_name": "Sarah Chen",
    "email": "sarah@example.com",
    "title": "Partner",
    "organization": "Acme Ventures"
  }
}
{
  "id": "22222222-2222-4222-8222-222222222222",
  "default": {
    "name": "Acme Ventures",
    "domain": "example.com",
    "industry": "Venture Capital"
  }
}
{
  "id": "33333333-3333-4333-8333-333333333333",
  "default": {
    "name": "Acme Ventures — Series A",
    "amount": 2500000,
    "stage": "negotiation",
    "organization": "Acme Ventures"
  }
}
{
  "id": "44444444-4444-4444-8444-444444444444",
  "default": {
    "name": "Follow up with Sarah Chen",
    "status": "open",
    "due_date": "2026-08-06",
    "contact": "Sarah Chen"
  }
}
{
  "id": "55555555-5555-4555-8555-555555555555",
  "default": {
    "name": "Acme Ventures — Series A notes",
    "content": "Sarah Chen is coordinating diligence for the Series A.",
    "organization": "Acme Ventures"
  }
}