MemoriesAjouter une Memory

Ajouter une Memory

Ajoute UNE Memory dans un Space du compte, sur un pilier, dans la limite de la capacité du compte. Aucune suppression n'est exposée. La Memory est enregistrée avec source: "API". Le membre derrière le credential doit avoir le droit d'écrire dans le Brain.

L'en-tête Idempotency-Key est obligatoire :

  • même clé + même contenu : 200, la même Memory, en-tête Idempotent-Replayed: true ;
  • même clé + autre contenu : 409 idempotency_conflict, rien n'est écrit.

Corps limité à 128 Kio.

curl -X POST "https://orbit.easyconnector.app/api/v1/spaces/example_string/memories" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: commande-1234-note" \
  -H "Authorization: Bearer YOUR_API_TOKEN (orb_)" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
  "pillar": "KNOWLEDGE",
  "title": "Livraison",
  "body": "48 h en France métropolitaine."
}'
{
  "object": "example_string",
  "id": "example_string",
  "spaceId": "example_string",
  "pillar": "IDENTITY",
  "parentId": "null",
  "kind": "example_string",
  "title": "example_string",
  "body": "example_string",
  "source": "REPO",
  "createdAt": "2024-12-25T10:00:00Z",
  "updatedAt": "2024-12-25T10:00:00Z"
}
POST
/spaces/{id}/memories
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token (orb_)
Bearer Tokenstring
Required

Clé développeur Orbit : orb_ suivi de 64 caractères hexadécimaux. Scopes cochés à la création (défaut brain:read projects:read). Expiration au choix (30, 90, 365 jours ou jamais), révocation immédiate.

Clé développeur Orbit : orb_ suivi de 64 caractères hexadécimaux. Scopes cochés à la création (défaut brain:read projects:read). Expiration au choix (30, 90, 365 jours ou jamais), révocation immédiate.
OAuth 2.0
OAuth 2.0 Tokenstring
Required

OAuth 2.1, Authorization Code avec PKCE S256 obligatoire, clients publics uniquement (enregistrement dynamique sur https://orbit.easyconnector.app/api/oauth/register). Paramètre resource obligatoire à l'autorisation. Jeton d'accès 1 heure, refresh token 30 jours, rotatif.

OAuth 2.1, Authorization Code avec PKCE S256 obligatoire, clients publics uniquement (enregistrement dynamique sur https://orbit.easyconnector.app/api/oauth/register). Paramètre resource obligatoire à l'autorisation. Jeton d'accès 1 heure, refresh token 30 jours, rotatif.
path
idstring
Required

Identifiant du Space (voir GET /spaces).

Content-Typestring
Required

The media type of the request body

Options: application/json
header
Idempotency-Keystring
Required

1 à 200 caractères ASCII visibles, choisis par le client.

Min length: 1 • Max length: 200 • Pattern: ^[\x21-\x7E]{1,200}$
pillarstring
Required

Rôle de pilier, identique pour tous les gabarits. Le libellé affiché dépend du gabarit (label, pillarLabel).

Options: IDENTITY, GUIDELINES, KNOWLEDGE, ITEMS, PEOPLE
titlestring
Required
Min length: 1 • Max length: 120
bodystring
Required
Max length: 20000
kindstring

Libellé libre de la Memory.

Min length: 1 • Max length: 40
parentIdstring

Imbriquer sous cette Memory du même Space.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (orb_). Clé développeur Orbit : orb_ suivi de 64 caractères hexadécimaux. Scopes cochés à la création (défaut brain:read projects:read). Expiration au choix (30, 90, 365 jours ou jamais), révocation immédiate.

header
Authorizationstring
Required

OAuth 2.0 access token. OAuth 2.1, Authorization Code avec PKCE S256 obligatoire, clients publics uniquement (enregistrement dynamique sur https://orbit.easyconnector.app/api/oauth/register). Paramètre resource obligatoire à l'autorisation. Jeton d'accès 1 heure, refresh token 30 jours, rotatif.

Available Flowsinfo

Supported OAuth 2.0 flows: authorizationCode

Path Parameters

idstring
Required

Identifiant du Space (voir GET /spaces).

Headers

Idempotency-Keystring
Required

1 à 200 caractères ASCII visibles, choisis par le client.

Example:
commande-1234-note

Body

application/json
pillarstring
Required

Rôle de pilier, identique pour tous les gabarits. Le libellé affiché dépend du gabarit (label, pillarLabel).

Allowed values:IDENTITYGUIDELINESKNOWLEDGEITEMSPEOPLE
kindstring

Libellé libre de la Memory.

parentIdstring

Imbriquer sous cette Memory du même Space.

Responses

objectstring
Required
idstring
Required
spaceIdstring
Required
pillarstring
Required

Rôle de pilier, identique pour tous les gabarits. Le libellé affiché dépend du gabarit (label, pillarLabel).

Allowed values:IDENTITYGUIDELINESKNOWLEDGEITEMSPEOPLE
parentIdstring,null
Required
kindstring
Required
titlestring
Required
bodystring
Required
sourcestring
Required

Origine d'une Memory.

Allowed values:REPOWEBSITEUPLOADCHATLOOPMANUALCONNECTORMCPAPI
createdAtstring
Required
updatedAtstring
Required