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êteIdempotent-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."
}'
import requests
import json
url = "https://orbit.easyconnector.app/api/v1/spaces/example_string/memories"
headers = {
"Content-Type": "application/json",
"Idempotency-Key": "commande-1234-note",
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
data = {
"pillar": "KNOWLEDGE",
"title": "Livraison",
"body": "48 h en France métropolitaine."
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://orbit.easyconnector.app/api/v1/spaces/example_string/memories", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Idempotency-Key": "commande-1234-note",
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
body: JSON.stringify({
"pillar": "KNOWLEDGE",
"title": "Livraison",
"body": "48 h en France métropolitaine."
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"pillar": "KNOWLEDGE",
"title": "Livraison",
"body": "48 h en France métropolitaine."
}`)
req, err := http.NewRequest("POST", "https://orbit.easyconnector.app/api/v1/spaces/example_string/memories", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Idempotency-Key", "commande-1234-note")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (orb_)")
req.Header.Set("Authorization", "Bearer YOUR_ACCESS_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://orbit.easyconnector.app/api/v1/spaces/example_string/memories')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Idempotency-Key'] = 'commande-1234-note'
request['Authorization'] = 'Bearer YOUR_API_TOKEN (orb_)'
request['Authorization'] = 'Bearer YOUR_ACCESS_TOKEN'
request.body = '{
"pillar": "KNOWLEDGE",
"title": "Livraison",
"body": "48 h en France métropolitaine."
}'
response = http.request(request)
puts response.body
{
"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"
}
{
"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"
}
{
"error": {
"code": "pillar_invalid",
"message": "Pilier inconnu. Valeurs : IDENTITY, GUIDELINES, KNOWLEDGE, ITEMS, PEOPLE."
}
}
{
"error": {
"code": "invalid_api_key",
"message": "Clé développeur ou jeton OAuth absent, expiré ou révoqué."
}
}
{
"error": {
"code": "capacity_full",
"message": "La capacité du Brain de ce compte est pleine : rien n'a été écrit."
}
}
{
"error": {
"code": "insufficient_scope",
"message": "Ce credential n'a pas le scope brain:write."
}
}
{
"error": {
"code": "not_found",
"message": "Space introuvable dans ce compte."
}
}
{
"error": {
"code": "idempotency_conflict",
"message": "Cette Idempotency-Key a déjà servi pour un contenu différent."
}
}
{
"error": {
"code": "payload_too_large",
"message": "Requête trop volumineuse."
}
}
{
"error": {
"code": "rate_limited",
"message": "Trop de requêtes."
}
}
/spaces/{id}/memoriesTarget server for requests. Edit to use your own host.
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.
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.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.
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.
Identifiant du Space (voir GET /spaces).
The media type of the request body
1 à 200 caractères ASCII visibles, choisis par le client.
Rôle de pilier, identique pour tous les gabarits. Le libellé affiché
dépend du gabarit (label, pillarLabel).
Libellé libre de la Memory.
Imbriquer sous cette Memory du même Space.
Request Preview
Response
Response will appear here after sending the request
Authentication
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.
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.
Supported OAuth 2.0 flows: authorizationCode
Path Parameters
Identifiant du Space (voir GET /spaces).
Headers
1 à 200 caractères ASCII visibles, choisis par le client.
commande-1234-noteBody
Rôle de pilier, identique pour tous les gabarits. Le libellé affiché
dépend du gabarit (label, pillarLabel).
IDENTITYGUIDELINESKNOWLEDGEITEMSPEOPLELibellé libre de la Memory.
Imbriquer sous cette Memory du même Space.
Responses
Rôle de pilier, identique pour tous les gabarits. Le libellé affiché
dépend du gabarit (label, pillarLabel).
IDENTITYGUIDELINESKNOWLEDGEITEMSPEOPLEOrigine d'une Memory.
REPOWEBSITEUPLOADCHATLOOPMANUALCONNECTORMCPAPI