Skip to main content

GraphQL API

Documentation de l'API GraphQL de Genesis AI.

📡 Endpoint​

Production : https://api.genesisai.io/graphql
Development : http://localhost:3000/graphql

🔐 Authentication​

Authorization: Bearer <JWT_TOKEN>

📖 Schema​

Types​

type Workflow {
  id: ID!
  name: String!
  description: String
  status: WorkflowStatus!
  encryptedData: String!
  createdAt: DateTime!
  updatedAt: DateTime!
}

enum WorkflowStatus {
  DRAFT
  RUNNING
  COMPLETED
  FAILED
  ARCHIVED
}

type Agent {
  id: ID!
  name: String!
  capabilities: [String!]!
  status: AgentStatus!
  isPublic: Boolean!
}

type SyncState {
  id: ID!
  type: String!
  entityId: String!
  encryptedData: String!
  version: String!
  updatedAt: DateTime!
}

🔍 Queries​

Lister les workflows​

query ListWorkflows($status: WorkflowStatus, $limit: Int) {
  workflows(status: $status, limit: $limit) {
    id
    name
    status
    createdAt
  }
}

Obtenir un workflow​

query GetWorkflow($id: ID!) {
  workflow(id: $id) {
    id
    name
    description
    status
    encryptedData
  }
}

Lister les agents​

query ListAgents($status: AgentStatus) {
  agents(status: $status) {
    id
    name
    capabilities
    status
  }
}

✏️ Mutations​

Créer un workflow​

mutation CreateWorkflow($input: CreateWorkflowInput!) {
  createWorkflow(input: $input) {
    id
    name
    status
  }
}

input CreateWorkflowInput {
  name: String!
  description: String
  encryptedData: String!
  encryptionKey: String!
}

Exécuter un workflow​

mutation ExecuteWorkflow($id: ID!, $input: JSON) {
  executeWorkflow(id: $id, input: $input) {
    executionId
    status
    result
  }
}

🔔 Subscriptions​

Workflow status changed​

subscription WorkflowStatusChanged {
  workflowStatusChanged {
    workflowId
    status
    updatedAt
  }
}

Sync state updated​

subscription SyncStateUpdated {
  syncStateUpdated {
    type
    entityId
    version
    updatedAt
  }
}

🧪 Exemple complet​

# Requête
mutation CreateAndExecute($input: CreateWorkflowInput!) {
  create: createWorkflow(input: $input) {
    id
    name
  }
  execute: executeWorkflow(id: $create.id) {
    executionId
    status
  }
}

# Variables
{
  "input": {
    "name": "My Workflow",
    "encryptedData": "...",
    "encryptionKey": "..."
  }
}

Version : 1.0.0