Get Upload File Metadata

GET /v1/workspaces/{workspaceId}/upload-file-metadata/{uploadFileMetadataId}

{
  "knowledge": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "metadata": {
      "title": "Product Guide",
      "author": "John Doe",
      "version": "2.0"
    }
  },
  "spaceKnowledge": null
}

# Step 1: Generate access token (do this once, reuse for multiple requests)
ACCESS_TOKEN=$(curl -s -X POST \
  'https://api.sharely.ai/workspaces/your-workspace-id/generate-access-key-token' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: sk-sharely-your-api-key' \
  -d '{}' | jq -r '.token')
 
# Step 2: Get upload file metadata
curl -X GET \
  'https://api.sharely.ai/v1/workspaces/your-workspace-id/upload-file-metadata/upload-metadata-id' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'organizationid: your-organization-id'

const API_KEY = 'sk-sharely-your-api-key';
const WORKSPACE_ID = 'your-workspace-id';
const ORGANIZATION_ID = 'your-organization-id';
const API_BASE_URL = 'https://api.sharely.ai';
 
// Step 1: Generate access token
async function getAccessToken() {
  const response = await fetch(
    `${API_BASE_URL}/workspaces/${WORKSPACE_ID}/generate-access-key-token`,
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': API_KEY
      },
      body: JSON.stringify({})
    }
  );
  const data = await response.json();
  return data.token;
}
 
// Step 2: Get upload file metadata
async function getUploadFileMetadata(accessToken, uploadFileMetadataId) {
  const response = await fetch(
    `${API_BASE_URL}/v1/workspaces/${WORKSPACE_ID}/upload-file-metadata/${uploadFileMetadataId}`,
    {
      headers: {
        'Authorization': `Bearer ${accessToken}`,
        'organizationid': ORGANIZATION_ID
      }
    }
  );
 
  if (!response.ok) {
    throw new Error(`Failed to get metadata: ${response.statusText}`);
  }
 
  return await response.json();
}
 
// Usage
const accessToken = await getAccessToken();
const result = await getUploadFileMetadata(accessToken, 'upload-metadata-id');
 
if (result.knowledge) {
  console.log('Workspace Knowledge ID:', result.knowledge.id);
  console.log('Metadata:', result.knowledge.metadata);
}
 
if (result.spaceKnowledge) {
  console.log('Space Knowledge ID:', result.spaceKnowledge.id);
}

// After uploading a file, use the returned metadata ID to track it
async function uploadAndTrack(accessToken, file) {
  // Upload the file
  const formData = new FormData();
  formData.append('file', file);
  formData.append('status', 'BACKGROUND_START');
 
  const uploadResponse = await fetch(
    `${API_BASE_URL}/v1/workspaces/${WORKSPACE_ID}/knowledge/file`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${accessToken}`,
        'organizationid': ORGANIZATION_ID
      },
      body: formData
    }
  );
 
  const uploadResult = await uploadResponse.json();
 
  // Later, retrieve the knowledge item using the upload metadata ID
  const metadata = await getUploadFileMetadata(
    accessToken,
    uploadResult.uploadFileMetadataId
  );
 
  return {
    uploadId: uploadResult.uploadFileMetadataId,
    knowledgeId: metadata.knowledge?.id,
    metadata: metadata.knowledge?.metadata
  };
}

{
  "error": "Unauthorized",
  "message": "Invalid or missing access token"
}

{
  "error": "Error",
  "message": "Upload file metadata with ID {id} not found"
}