diff --git a/openapi/vosi/vosi-anon-read.yaml b/openapi/vosi/vosi-anon-read.yaml
new file mode 100644
index 0000000..da0201e
--- /dev/null
+++ b/openapi/vosi/vosi-anon-read.yaml
@@ -0,0 +1,8 @@
+# request header
+name: x-vosi-anon-read
+in: header
+description: flag indicating that the resource allows anonymous read
+required: false
+schema:
+  type: boolean
+
diff --git a/openapi/vosi/vosi-group-read.yaml b/openapi/vosi/vosi-group-read.yaml
new file mode 100644
index 0000000..34c40b5
--- /dev/null
+++ b/openapi/vosi/vosi-group-read.yaml
@@ -0,0 +1,7 @@
+# request header
+name: x-vosi-group-read
+in: header
+description: a GMS group identifier indicating a group with read permission
+required: false
+schema:
+  type: string
diff --git a/openapi/vosi/vosi-group-write.yaml b/openapi/vosi/vosi-group-write.yaml
new file mode 100644
index 0000000..3d112a2
--- /dev/null
+++ b/openapi/vosi/vosi-group-write.yaml
@@ -0,0 +1,7 @@
+# request header
+name: x-vosi-group-write
+in: header
+description: a GMS group identifier indicating a group with write permission
+required: false
+schema:
+  type: string
diff --git a/openapi/vosi/vosi-table.yaml b/openapi/vosi/vosi-table.yaml
index 2bee655..b39dbfb 100644
--- a/openapi/vosi/vosi-table.yaml
+++ b/openapi/vosi/vosi-table.yaml
@@ -34,6 +34,9 @@ post:
         required: true
         schema:
             type: string
+      - $ref: ./vosi-anon-read.yaml
+      - $ref: ./vosi-group-read.yaml
+      - $ref: ./vosi-group-write.yaml
     requestBody:
         description: a table description
         $ref: '#/components/schemas/tableDoc'
@@ -65,6 +68,9 @@ put:
         required: true
         schema:
             type: string
+      - $ref: ./vosi-anon-read.yaml
+      - $ref: ./vosi-group-read.yaml
+      - $ref: ./vosi-group-write.yaml
     requestBody:
         description: a table description
         $ref: '#/components/schemas/tableDoc'
@@ -112,15 +118,36 @@ components:
     schemas:
         tableDoc:
             description: metadata for the specified schema or table
+            headers:
+              x-vosi-owner:
+                description: identifier for the owner of the schema or table
+                required: false
+                schema:
+                  type: string
+              x-vosi-anon-read:
+                description: flag indicating that the resource allows anonymous read
+                required: false
+                schema:
+                  type: boolean
+              x-vosi-group-read:
+                description: a GMS group identifier indicating a group with read permission
+                required: false
+                schema:
+                  type: string
+              x-vosi-group-write:
+                description: a GMS group identifier indicating a group with write permission
+                required: false
+                schema:
+                  type: string
             content:
                 text/xml:
                     schema:
-                        type: object
-                        xml:
-                            name: table
-                            prefix: vosi
-                            namespace: http://www.ivoa.net/xml/VOSITables/v1.0
-                    example: |
+                      type: string
+                      xml:
+                        name: table
+                        prefix: vosi
+                        namespace: http://www.ivoa.net/xml/VOSITables/v1.0
+                      example: |
                         <vosi:table xmlns:vosi="http://www.ivoa.net/xml/VOSITables/v1.0"
                                 xmlns:vs="http://www.ivoa.net/xml/VODataService/v1.1"
                                 xmlns:vte="http://www.opencadc.org/xml/VOSITables-ext/v0.1"
@@ -148,18 +175,18 @@ components:
                               <description>recommended sort order when listing schemas</description>
                               <dataType xsi:type="vs:VOTableType">int</dataType>
                             </column>
-                          </vosi:table>
+                        </vosi:table>
                 application/x-votable+xml:
                     schema:
-                        type: object
-                        xml:
-                            name: VOTABLE
-                            namespace: http://www.ivoa.net/xml/VOTable/v1.3
-                    example: |
+                      type: string
+                      xml:
+                        name: VOTABLE
+                        namespace: http://www.ivoa.net/xml/VOTable/v1.3
+                      example: |
                         <VOTABLE xmlns="http://www.ivoa.net/xml/VOTable/v1.3"
                                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.4">
                             <RESOURCE type="results">
-                                <TABLE>
+                              <TABLE>
                                 <FIELD name="schema_name" datatype="char" arraysize="64*">
                                     <DESCRIPTION>schema name for reference to tap_schema.schemas</DESCRIPTION>
                                 </FIELD>
@@ -172,9 +199,6 @@ components:
                                 <FIELD name="schema_index" datatype="int">
                                     <DESCRIPTION>recommended sort order when listing schemas</DESCRIPTION>
                                 </FIELD>
-                                <!--data goes here-->
                               </TABLE>
                             </RESOURCE>
                         </VOTABLE>
-
-
diff --git a/openapi/vosi/vosi-tableset.yaml b/openapi/vosi/vosi-tableset.yaml
index be950cc..7a85064 100644
--- a/openapi/vosi/vosi-tableset.yaml
+++ b/openapi/vosi/vosi-tableset.yaml
@@ -29,12 +29,12 @@ components:
             content:
                 text/xml:
                     schema:
-                        type: string
-                        xml:
-                            name: tableset
-                            prefix: vosi
-                            namespace: http://www.ivoa.net/xml/VOSITables/v1.0
-                    example: |
+                      type: string
+                      xml:
+                        name: tableset
+                        prefix: vosi
+                        namespace: http://www.ivoa.net/xml/VOSITables/v1.0
+                      example: |
                         <vosi:tableset xmlns:vosi="http://www.ivoa.net/xml/VOSITables/v1.0"
                                 xmlns:vs="http://www.ivoa.net/xml/VODataService/v1.1"
                                 xmlns:vte="http://www.opencadc.org/xml/VOSITables-ext/v0.1"
@@ -63,6 +63,5 @@ components:
                               <description>description of foreign key columns in this tableset</description>
                             </table>
                           </schema>
-                          ...
                         </vosi:tableset>