Datasets

GET `/api/v1/datasets`

Get Datasets

Response

Type: []Dataset

Field	Type	Description
`id`	`uuid.UUID`
`created_at`	`time.Time`
`updated_at`	`time.Time`
`name`	`string`
`description`	`string`
`user_id`	`string`
`notes`	`string`
`has_logo`	`bool`
`logo`	`string`
`public`	`bool`
`shared_with_me`	`bool`
`share_role`	`string`	Role slug if shared (share_viewer, share_editor) (optional)
`organization_id`	`string`	Multi-tenancy fields (Phase 1 RBAC)
These are nullable to maintain backward compatibility - resources without
org/project assignment belong to the user’s “personal workspace” (optional)
`project_id`	`string`	(optional)
`visibility`	`string`	Visibility controls access inheritance (defaults to existing Public behavior)
“private” = only explicit grants, “project” = project members, “team” = team members,
“org” = org members, “public” = anyone (same as Public=true) (optional)
`versions`	`[]DatasetVersion`
`multi_label`	`bool`
`default_splits`	`bool`
`content_type`	`string`

Example

curl -X GET \
  -H "Authorization: Bearer <token>" \
  https://api.seeme.ai/api/v1/datasets

POST `/api/v1/datasets`

Create Dataset

Request Body

Type: Dataset

Field	Type	Description
`id`	`uuid.UUID`
`created_at`	`time.Time`
`updated_at`	`time.Time`
`name`	`string`
`description`	`string`
`user_id`	`string`
`notes`	`string`
`has_logo`	`bool`
`logo`	`string`
`public`	`bool`
`shared_with_me`	`bool`
`share_role`	`string`	Role slug if shared (share_viewer, share_editor) (optional)
`organization_id`	`string`	Multi-tenancy fields (Phase 1 RBAC)
These are nullable to maintain backward compatibility - resources without
org/project assignment belong to the user’s “personal workspace” (optional)
`project_id`	`string`	(optional)
`visibility`	`string`	Visibility controls access inheritance (defaults to existing Public behavior)
“private” = only explicit grants, “project” = project members, “team” = team members,
“org” = org members, “public” = anyone (same as Public=true) (optional)
`versions`	`[]DatasetVersion`
`multi_label`	`bool`
`default_splits`	`bool`
`content_type`	`string`

Response

Type: Dataset

Field	Type	Description
`id`	`uuid.UUID`
`created_at`	`time.Time`
`updated_at`	`time.Time`
`name`	`string`
`description`	`string`
`user_id`	`string`
`notes`	`string`
`has_logo`	`bool`
`logo`	`string`
`public`	`bool`
`shared_with_me`	`bool`
`share_role`	`string`	Role slug if shared (share_viewer, share_editor) (optional)
`organization_id`	`string`	Multi-tenancy fields (Phase 1 RBAC)
These are nullable to maintain backward compatibility - resources without
org/project assignment belong to the user’s “personal workspace” (optional)
`project_id`	`string`	(optional)
`visibility`	`string`	Visibility controls access inheritance (defaults to existing Public behavior)
“private” = only explicit grants, “project” = project members, “team” = team members,
“org” = org members, “public” = anyone (same as Public=true) (optional)
`versions`	`[]DatasetVersion`
`multi_label`	`bool`
`default_splits`	`bool`
`content_type`	`string`

Example

curl -X POST \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://api.seeme.ai/api/v1/datasets

GET `/api/v1/datasets/{id}`

Get Dataset

Parameters

Name	In	Type	Required
`id`	path	string	true

Response

Type: Dataset

Field	Type	Description
`id`	`uuid.UUID`
`created_at`	`time.Time`
`updated_at`	`time.Time`
`name`	`string`
`description`	`string`
`user_id`	`string`
`notes`	`string`
`has_logo`	`bool`
`logo`	`string`
`public`	`bool`
`shared_with_me`	`bool`
`share_role`	`string`	Role slug if shared (share_viewer, share_editor) (optional)
`organization_id`	`string`	Multi-tenancy fields (Phase 1 RBAC)
These are nullable to maintain backward compatibility - resources without
org/project assignment belong to the user’s “personal workspace” (optional)
`project_id`	`string`	(optional)
`visibility`	`string`	Visibility controls access inheritance (defaults to existing Public behavior)
“private” = only explicit grants, “project” = project members, “team” = team members,
“org” = org members, “public” = anyone (same as Public=true) (optional)
`versions`	`[]DatasetVersion`
`multi_label`	`bool`
`default_splits`	`bool`
`content_type`	`string`

Example

curl -X GET \
  -H "Authorization: Bearer <token>" \
  https://api.seeme.ai/api/v1/datasets/{id}

PUT `/api/v1/datasets/{id}`

Update Dataset

Parameters

Name	In	Type	Required
`id`	path	string	true

Request Body

Type: Dataset

Field	Type	Description
`id`	`uuid.UUID`
`created_at`	`time.Time`
`updated_at`	`time.Time`
`name`	`string`
`description`	`string`
`user_id`	`string`
`notes`	`string`
`has_logo`	`bool`
`logo`	`string`
`public`	`bool`
`shared_with_me`	`bool`
`share_role`	`string`	Role slug if shared (share_viewer, share_editor) (optional)
`organization_id`	`string`	Multi-tenancy fields (Phase 1 RBAC)
These are nullable to maintain backward compatibility - resources without
org/project assignment belong to the user’s “personal workspace” (optional)
`project_id`	`string`	(optional)
`visibility`	`string`	Visibility controls access inheritance (defaults to existing Public behavior)
“private” = only explicit grants, “project” = project members, “team” = team members,
“org” = org members, “public” = anyone (same as Public=true) (optional)
`versions`	`[]DatasetVersion`
`multi_label`	`bool`
`default_splits`	`bool`
`content_type`	`string`

Response

Type: Dataset

Field	Type	Description
`id`	`uuid.UUID`
`created_at`	`time.Time`
`updated_at`	`time.Time`
`name`	`string`
`description`	`string`
`user_id`	`string`
`notes`	`string`
`has_logo`	`bool`
`logo`	`string`
`public`	`bool`
`shared_with_me`	`bool`
`share_role`	`string`	Role slug if shared (share_viewer, share_editor) (optional)
`organization_id`	`string`	Multi-tenancy fields (Phase 1 RBAC)
These are nullable to maintain backward compatibility - resources without
org/project assignment belong to the user’s “personal workspace” (optional)
`project_id`	`string`	(optional)
`visibility`	`string`	Visibility controls access inheritance (defaults to existing Public behavior)
“private” = only explicit grants, “project” = project members, “team” = team members,
“org” = org members, “public” = anyone (same as Public=true) (optional)
`versions`	`[]DatasetVersion`
`multi_label`	`bool`
`default_splits`	`bool`
`content_type`	`string`

Example

curl -X PUT \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://api.seeme.ai/api/v1/datasets/{id}

DELETE `/api/v1/datasets/{id}`

Delete Dataset

Parameters

Name	In	Type	Required
`id`	path	string	true

Example

curl -X DELETE \
  -H "Authorization: Bearer <token>" \
  https://api.seeme.ai/api/v1/datasets/{id}

GET `/api/v1/datasets/{id}/logo`

Get Dataset Logo

Parameters

Name	In	Type	Required
`id`	path	string	true

Example

curl -X GET \
  -H "Authorization: Bearer <token>" \
  https://api.seeme.ai/api/v1/datasets/{id}/logo

GET `/api/v1/datasets/{id}/share`

Get Shares

Parameters

Name	In	Type	Required
`id`	path	string	true

Response

Type: []ShareInfo

Field	Type	Description
`share_id`	`string`
`user_id`	`string`
`firstname`	`string`
`name`	`string`
`email`	`string`
`request_user_id`	`string`	The userID that shares
`role_id`	`string`
`role_name`	`string`
`role_slug`	`string`
`is_pending`	`bool`
`is_owner`	`bool`

Example

curl -X GET \
  -H "Authorization: Bearer <token>" \
  https://api.seeme.ai/api/v1/datasets/{id}/share

POST `/api/v1/datasets/{id}/share`

Create Share

Parameters

Name	In	Type	Required
`id`	path	string	true

Request Body

Type: Share

Field	Type	Description
`id`	`uuid.UUID`
`created_at`	`time.Time`
`updated_at`	`time.Time`
`user_id`	`uuid.UUID`	The userID it is shared with
`email`	`string`
`entity_id`	`string`
`entity_version_id`	`string`
`request_user_id`	`string`	The userID that shares
`entity_type`	`string`
`without_invite`	`bool`	Do not send an email invitation
`role_id`	`string`	Optional: role for granular permissions (defaults to viewer)
`token`	`string`	Invite fields (for new-user invite flow) (optional)
`expires_at`	`time.Time`	(optional)
`accepted_at`	`time.Time`	(optional)
`role`	`Role`	Relationships (optional)

Response

Type: Share

Field	Type	Description
`id`	`uuid.UUID`
`created_at`	`time.Time`
`updated_at`	`time.Time`
`user_id`	`uuid.UUID`	The userID it is shared with
`email`	`string`
`entity_id`	`string`
`entity_version_id`	`string`
`request_user_id`	`string`	The userID that shares
`entity_type`	`string`
`without_invite`	`bool`	Do not send an email invitation
`role_id`	`string`	Optional: role for granular permissions (defaults to viewer)
`token`	`string`	Invite fields (for new-user invite flow) (optional)
`expires_at`	`time.Time`	(optional)
`accepted_at`	`time.Time`	(optional)
`role`	`Role`	Relationships (optional)

Example

curl -X POST \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://api.seeme.ai/api/v1/datasets/{id}/share

PUT `/api/v1/datasets/{id}/share/{share_id}`

Update Share

putShare updates a share’s role

Parameters

Name	In	Type	Required
`id`	path	string	true
`share_id`	path	string	true

Request Body

Type: struct{}

Example

curl -X PUT \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://api.seeme.ai/api/v1/datasets/{id}/share/{share_id}

DELETE `/api/v1/datasets/{id}/share/{share_id}`

Delete Share

func deleteShare(db *gorm.DB, entityType string) http.HandlerFunc {

Parameters

Name	In	Type	Required
`id`	path	string	true
`share_id`	path	string	true

Example

curl -X DELETE \
  -H "Authorization: Bearer <token>" \
  https://api.seeme.ai/api/v1/datasets/{id}/share/{share_id}

POST `/api/v1/datasets/{id}/upload`

Create Dataset Logo

Parameters

Name	In	Type	Required
`id`	path	string	true

Response

Type: Dataset

Field	Type	Description
`id`	`uuid.UUID`
`created_at`	`time.Time`
`updated_at`	`time.Time`
`name`	`string`
`description`	`string`
`user_id`	`string`
`notes`	`string`
`has_logo`	`bool`
`logo`	`string`
`public`	`bool`
`shared_with_me`	`bool`
`share_role`	`string`	Role slug if shared (share_viewer, share_editor) (optional)
`organization_id`	`string`	Multi-tenancy fields (Phase 1 RBAC)
These are nullable to maintain backward compatibility - resources without
org/project assignment belong to the user’s “personal workspace” (optional)
`project_id`	`string`	(optional)
`visibility`	`string`	Visibility controls access inheritance (defaults to existing Public behavior)
“private” = only explicit grants, “project” = project members, “team” = team members,
“org” = org members, “public” = anyone (same as Public=true) (optional)
`versions`	`[]DatasetVersion`
`multi_label`	`bool`
`default_splits`	`bool`
`content_type`	`string`

Example

curl -X POST \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  https://api.seeme.ai/api/v1/datasets/{id}/upload

Datasets

GET /api/v1/datasets

Response

Example

POST /api/v1/datasets

Request Body

Response

Example

GET /api/v1/datasets/{id}

Parameters

Response

Example

PUT /api/v1/datasets/{id}

Parameters

Request Body

Response

Example

DELETE /api/v1/datasets/{id}

Parameters

Example

GET /api/v1/datasets/{id}/logo

Parameters

Example

GET /api/v1/datasets/{id}/share

Parameters

Response

Example

POST /api/v1/datasets/{id}/share

Parameters

Request Body

Response

Example

PUT /api/v1/datasets/{id}/share/{share_id}

Parameters

Request Body

Example

DELETE /api/v1/datasets/{id}/share/{share_id}

Parameters

Example

POST /api/v1/datasets/{id}/upload

Parameters

Response

Example

GET `/api/v1/datasets`

POST `/api/v1/datasets`

GET `/api/v1/datasets/{id}`

PUT `/api/v1/datasets/{id}`

DELETE `/api/v1/datasets/{id}`

GET `/api/v1/datasets/{id}/logo`

GET `/api/v1/datasets/{id}/share`

POST `/api/v1/datasets/{id}/share`

PUT `/api/v1/datasets/{id}/share/{share_id}`

DELETE `/api/v1/datasets/{id}/share/{share_id}`

POST `/api/v1/datasets/{id}/upload`